SuperAPI AI 工具集

task-manager

办公与效率

查看项目

更新于 10-15 11:00

技能介绍

用途

需求管理(Task Manager)用于管理需求的全生命周期:收集、排序、清理、跟踪。核心职责是维护 docs/backlog/ 目录下的需求文件和 INDEX.md 索引,并通过需求状态变更驱动整个工作流。

主要能力

  • 收集:新需求写入 docs/backlog/,更新 INDEX。
  • 排序:定期重新评估优先级(P0-P3)。
  • 清理:过期或无效需求标记 dropped,保持 backlog 清洁。
  • 跟踪:需求状态流转 open → in-progress → done / dropped。

需求状态定义:

  • open:已收集,待排期,需求创建时触发。
  • in-progress:开发中,task-start 启动时触发,方便跨会话跟踪进度。
  • done:彻底完成,用户确认关闭时触发复盘 + Ingest。
  • dropped:放弃,需求失效或优先级归零时记录 drop 原因。

使用方式

新增需求

文件路径:docs/backlog/YYYY-MM-DD-<主题>.md,包含 frontmatter(priority、status、spec、plan)以及背景、描述、验收标准。创建后更新 docs/backlog/INDEX.md,按优先级放到对应分组。

梳理 backlog

触发时机:用户主动要求梳理、开新迭代/冲刺前、backlog 超过 15 个 open 需求时。

梳理流程:读取 INDEX.md 了解全貌,逐条检查 open 状态需求(是否还有价值、优先级是否正确、描述是否准确、是否有已完成未标记的),输出梳理结论。

优先级排序

优先级定义:P0 紧急(阻塞其他工作、线上问题、截止日期临近)、P1 重要(核心功能、用户高频需求、有明确截止时间)、P2 普通(有价值但不紧急、优化类)、P3 低优(锦上添花、远期规划、灵感记录)。

排序方法:先按紧急度分层,同层内按价值/成本比排序,有依赖关系的考虑顺序。

状态变更

  • open → in-progress:更新 backlog 文件 status + INDEX.md 中标注 [~]。
  • in-progress → done:触发关闭流程。
  • open/in-progress → dropped:更新 status + INDEX.md 中加删除线 + 写明 drop 原因。
  • 优先级调整:更新 priority + INDEX.md 中移动到对应分组。

需求关闭流程(open → done)

需求标 done 是整个工作流最重要的节点,是复盘和经验沉淀的唯一触发点。"编码完成"不等于"需求完成",需求完成 = 用户确认这个需求彻底搞定了。标 done 时必须提交代码,backlog 状态更新、复盘文档等变更不能积攒,随标 done 一起 commit。

流程步骤:更新 backlog 文件 status → done;更新 INDEX.md 中 [ ] → [x];复盘判断(小需求跳过、中等需求轻量复盘、大需求完整复盘);复盘产出写入 docs/decisions/YYYY-MM-DD-<主题>.md;记忆管理;触发 docs-management.Ingest;复盘中提到环境/工具链的坑则提醒补到 guides/;提到线上问题/部署问题则提醒补到 runbooks/;更新 docs/decisions/INDEX.md;提交代码。

强制完整复盘信号:需求过程中出现方向调整或重大返工、方案设计和实际执行有显著偏差、发现之前不知道的坑或隐含知识、用户明确要求复盘。

轻量复盘回答 3 个问题:方案和实际的偏差在哪、哪里返工了为什么、下次怎么避免。

完整复盘采用四维回顾:需求概述、做得好的(保持)、做得不够好的(优化)、通用能力沉淀、行动项。

经验沉淀路径

docs/decisions/ 是真相源,memory 只是跨会话索引,不允许只存 memory 不写文档。复盘全文存 docs/decisions/,关键经验存 memory(feedback/project 类型),通用规范提升到 CLAUDE.md。

记忆写入规则

memory 是"下次对话的备忘录",只存跨会话有用的信息,不存能从代码/git/docs 推导出的东西。写入判断三连问:下次对话还需要这个信息吗、能从代码/git log/docs 推导出来吗、会在 2 周内过期吗。不写代码结构、文件路径、函数签名、具体的 bug 修复方案。

记忆清理规则

触发时机:docs-management Lint 时顺带检查、对话开始时读到过期 memory、memory 条目超过 20 条时。清理判断标准包括 project 类型超过 1 个月未更新、feedback 类型描述的代码/模块已重构或删除、两条 memory 重复或矛盾、引用的文件/函数已不存在、内容已被沉淀到 CLAUDE.md 或 docs/。清理操作:删除 memory 文件 + 更新 MEMORY.md 索引。

INDEX.md 格式

按 P0-P3 分组,使用 [ ] 表示 open、[~] 表示 in-progress、[x] 表示 done、删除线 表示 dropped。

适用场景

适用于需要系统化管理需求生命周期的项目,尤其是使用 docs/backlog/ 目录和 INDEX.md 索引的工作流。需求状态变更是整个工作流的驱动力,与其他 skill 协同:task-start(对焦 + 方案)、task-execute(编码 + 进度管理)、task-finish(每次提交前自检)、docs-management(更新相关文档)。

限制

资料未提供具体的安装命令、收费信息、平台支持范围等细节。