创建时间：2025-12-27
一个通过自然语言管理任务的 Claude Code Skill，支持需求收集、自动整理、进度追踪、7天看板。
概述
Task Manager 是一个 Claude Code Skill，让你可以通过聊天来管理项目任务：
👤：添加需求：用户登录支持手机号
🤖：✅ 已创建 #011 用户登录支持手机号
项目：main-frontend | 优先级：P1
📋 当前任务（5 个待开发，2 个进行中）：
🚀 #001 AI Function 部署 [P1] 进度 30%
📥 #011 用户登录 [P1] ← 新增
...
核心特性
| 特性 | 说明 |
|---|---|
| 自然语言交互 | 「添加需求」「看板」「开始 5」 |
| 全局递增 ID | #001, #002... 简短好记 |
| 自动整理 | AI 判断项目归属、优先级、任务拆解 |
| 重复检测 | 添加时检查相似任务 |
| 多项目支持 | main-frontend / main-functions / new-project |
| 7天看板 | 进行中、待开发、已完成一目了然 |
| 并发安全 | 每个任务独立文件，日志只追加 |
目录结构
.claude/skills/task-manager/
├── SKILL.md # Skill 定义
└── data/ # 数据目录
├── _index.yaml # 索引（自动维护）
├── _dashboard.md # 7天看板
├── _config.yaml # 项目配置
├── ideas/ # 💡 想法池
├── inbox/ # 📥 待开发任务
│ ├── #001-xxx.md
│ └── #002-xxx.md
├── doing/ # 🚀 进行中（按项目分）
│ ├── main-frontend/
│ ├── main-functions/
│ └── new-project/
├── blocked/ # 🔴 阻塞
├── done/ # ✅ 已完成（按月）
│ └── 2025-12/
└── archive/ # 📦 长期归档
状态流转
💡 ideas（想法池）
↓
📥 inbox（待开发）
↓
🚀 doing（进行中）← 关联 git 分支
↓ ↘
✅ done 🔴 blocked
↓
📦 archive
命令一览
| 你说 | AI 做 |
|---|---|
| 添加需求：xxx | 检查重复 → 创建任务 → 显示列表 |
| 添加想法：xxx | 记录到想法池 |
| 看板 | 显示 7 天工作看板 |
| 开始 5 | 开始 #005 任务 + 创建分支 |
| #5 进度 60% | 更新进度 |
| 完成 5 | 完成任务，移到 done |
| P0 任务 | 按优先级筛选 |
文件格式
任务文件 (#NNN-标题.md)
---
id: 1
title: AI Function 部署上线环境
project: main-functions
priority: P1
status: inbox
branch: null
created_at: 2025-12-27
progress: 0
---
# #001 AI Function 部署上线环境
## 原始需求
> AI Function 部署上线环境（Vercel 或 Cloudflare）
## 注意事项
- 可选平台：Vercel 或 Cloudflare
- 需要评估两个平台的优劣
## 任务
- [ ] 评估部署方案
- [ ] 配置环境
- [ ] 部署上线
## 日志
- 12-27 16:00 创建需求
权限配置
1. SKILL.md frontmatter
---
name: task-manager
description: 任务需求管理与执行系统...
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
---
2. settings.local.json
{
"permissions": {
"allow": [
"Skill(task-manager)",
"Skill(task-manager:*)",
"Read(.claude/skills/task-manager/data/*)",
"Write(.claude/skills/task-manager/data/*)",
"Edit(.claude/skills/task-manager/data/*)"
]
}
}
设计原则
1. 文件即状态
移动文件 = 改变状态，git 天然记录历史。
# 开始任务
mv inbox/#001-xxx.md doing/main-functions/
# 完成任务
mv doing/main-functions/#001-xxx.md done/2025-12/
2. 日志只追加
更新进度只在文件末尾追加，不修改历史，避免并发冲突。
3. 索引是缓存
_index.yaml 可从各任务文件重建，不是真实来源。
4. 保留原始需求
整理时保留用户原话，不丢失细节。
开发要点
Skill 创建流程
- 创建目录：
.claude/skills/skill-name/ - 编写 SKILL.md：包含 frontmatter 和指令
- 配置权限：在
settings.local.json添加 allow 规则 - 重启 Claude Code：加载新 Skill
frontmatter 字段
| 字段 | 必填 | 说明 |
|---|---|---|
| name | ✅ | 小写+连字符，匹配目录名 |
| description | ✅ | 描述+触发词，< 1024 字符 |
| allowed-tools | ❌ | 限制可用工具 |
权限配置方式
| 配置位置 | 作用 |
|---|---|
| SKILL.md allowed-tools | 限制 Skill 能用哪些工具 |
| settings.local.json allow | 授权操作无需确认 |
扩展方向
- MCP 集成：连接外部任务管理工具
- Git 深度集成：自动关联 commit、PR
- AI 分析：任务完成率、平均周期
- 团队协作：多人任务分配
