312362115/claude/task-manager

需求管理 = 收集 + 排序 + 清理 + 跟踪

open ──→ in-progress ──→ done
  │                        │
  └──→ dropped             └─ 触发复盘 + 经验沉淀

# 文件：docs/backlog/YYYY-MM-DD-<主题>.md
 
---
priority: P2
status: open
spec: （关联方案，如有）
plan: （关联计划，如有）
---
 
# <需求标题>
 
## 背景
为什么要做这个？
 
## 描述
具体要做什么？
 
## 验收标准
做到什么程度算完？

1. 读取 docs/backlog/INDEX.md，了解全貌
2. 逐条检查 open 状态的需求：
   │
   ├─ 还有价值吗？
   │   └─ NO → 标记 dropped，说明原因
   │
   ├─ 优先级还对吗？
   │   └─ 调整 priority 和 INDEX 位置
   │
   ├─ 描述还准确吗？
   │   └─ 更新描述/验收标准
   │
   └─ 有没有已完成但没标记的？
       └─ 标记 done，更新 INDEX
3. 输出梳理结论

## Backlog 梳理结论 — YYYY-MM-DD
 
### 概况
-总计：X 条需求
-Open：X 条 | Done：X 条 | Dropped：X 条
 
### 本次调整
-P1 → P0：[需求名] — 原因
-P2 → dropped：[需求名] — 原因
-新增：[需求名] — P2
 
### 建议下一步做
1.[需求名](链接) — P0，理由
2.[需求名](链接) — P1，理由

1. 更新 backlog 文件 frontmatter: status: in-progress
2. 更新 INDEX.md: [ ] → [~]

用户说"这个需求做完了" / "标记完成" / "关闭这个需求"
  │
  ├─ Step 1: 更新 backlog 文件 status → done
  ├─ Step 2: 更新 INDEX.md 中 [ ] → [x]
  │
  ├─ Step 3: 复盘判断
  │   │
  │   ├─ 小需求（≤2 文件，过程顺利，无返工）？
  │   │   └─ 跳过复盘
  │   │
  │   ├─ 中等需求（过程中有波折但不大）？
  │   │   └─ 轻量复盘：回答 3 个问题
  │   │
  │   └─ 大需求 / 过程曲折 / 方向调整 / 反复修改？
  │       └─ 完整复盘：四维回顾
  │
  ├─ Step 4: 复盘产出写入 docs/decisions/YYYY-MM-DD-<主题>.md
  ├─ Step 5: 记忆管理（详见下方"记忆写入规则"）
  ├─ Step 6: 触发 docs-management.Ingest（更新相关 spec/plan 状态标注）
  ├─ Step 6.1: 复盘中提到环境/工具链的坑？→ 提醒补到 guides/
  ├─ Step 6.2: 复盘中提到线上问题/部署问题？→ 提醒补到 runbooks/
  ├─ Step 7: 更新 docs/decisions/INDEX.md（如果存在）
  └─ Step 8: 提交代码 — 将本次需求的所有变更（含 backlog 状态、复盘文档）一起 commit，不积攒

# 复盘：[需求名称] — YYYY-MM-DD
 
1.**方案和实际的偏差在哪？**
   -[偏差描述，没有偏差就写"无"]
 
2.**哪里返工了、为什么？**
   -[返工原因，没有返工就写"无"]
 
3.**下次怎么避免？**
   -[可复用的经验]

# 复盘：[需求名称] — YYYY-MM-DD
 
## 需求概述
-目标：[一句话描述]
-结果：[完成情况]
-过程顺利度：1-5 星
 
## 做得好的（保持）
-...
 
## 做得不够好的（优化）
-...（附原因分析）
 
## 通用能力沉淀
-...
 
## 行动项
-[ ] ...

# Backlog Index
 
## P0 — 紧急
<!-- 当前无 P0 -->
 
## P1 — 重要
-[~] [开发中的需求](文件名.md) — 一句话描述
-[ ] [待做需求](文件名.md) — 一句话描述
-[x] [已完成需求](文件名.md) — 一句话描述
 
## P2 — 普通
-[ ] [需求标题](文件名.md) — 一句话描述
 
## P3 — 低优
-[ ] [需求标题](文件名.md) — 一句话描述
-~~[已放弃需求](文件名.md) — 一句话描述~~

task-manager（本 skill）
  │
  ├─ open → 收集需求、排优先级
  │   ↓ 决定做某个需求
  │
  ├─ task-start → 对焦 + 方案
  │   ↓
  │ task-execute → 编码 + 进度管理
  │   ↓
  │ task-finish → 每次提交前自检
  │   ↓
  │ （手动测试、bug 修复、调整...可能反复多轮）
  │   ↓
  ├─ done → 需求彻底完成
  │   ├─ 复盘 → docs/decisions/（经验沉淀）
  │   ├─ Ingest → docs-management（更新相关文档）
  │   └─ memory → 跨会话索引
  │
  └─ dropped → 需求放弃，记录原因

task-start（检索 decisions/ 历史经验）→ 执行 → task-manager 标 done（产出新经验）
      ↑                                                    │
      └──────────────── docs/decisions/ ←──────────────────┘