关于 todo-resolve
此技能用于处理仓库中已批准且状态为 ready 的待办事项。它并行委派实施、记录经验,并清理已完成的待办文件,同时报告未处理的 pending 项。
主要功能
- 01区分 ready、pending 和 complete
- 02并行处理 ready 项
- 03记录经验教训
- 04清理已解决的待办文件
适用场景
- 01处理已批准的仓库待办事项
- 02保留未分类的 pending 项
- 03记录修复过程中发现的模式
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill todo-resolve安装后在 Claude Code 中输入/todo-resolve确认已加载。
详细介绍
使用并行处理来解决已批准的待办事项,记录经验教训,然后进行清理。
仅解决 ready 待办事项。跳过 pending 待办事项——这些事项尚未经过分类。如果存在 pending 待办事项,请在末尾列出,让用户知道有哪些事项尚未处理。
工作流
1. 分析
扫描 .context/compound-engineering/todos/*.md 和旧版 todos/*.md。按状态分类:
ready(状态字段为此值,或文件名包含-ready-):解决这些事项。pending:跳过。在末尾报告。complete:忽略,已完成。
如果传入了特定待办事项 ID 或模式作为参数,则仅筛选匹配的待办事项(但仍必须是 ready)。
ce:review mode:autofix 的 safe_auto 阶段之后遗留的可执行工作,已标记为 ready。
跳过任何建议删除、移除或通过 Git 忽略 docs/brainstorms/、docs/plans/ 或 docs/solutions/ 中文件的待办事项——这些是有意保留的流水线产物。
2. 规划
按类型分组创建任务列表(例如,在 Claude Code 中使用 TaskCreate,在 Codex 中使用 update_plan)。分析依赖关系——先执行其他事项所依赖的任务。输出一个 Mermaid 图,展示执行顺序和并行关系。
3. 实施(并行)
为每个事项启动一个 compound-engineering:workflow:pr-comment-resolver Agent。优先并行处理;如不可行,则按依赖顺序依次处理。
**分批处理:**1-4 个事项:直接并行返回。5 个或更多事项:每批 4 个,每个事项仅返回简短的状态摘要(已处理的待办事项、变更的文件、已运行/跳过的测试、阻塞因素)。
对于大量事项,在 .context/compound-engineering/todo-resolve/<run-id>/ 中创建临时目录,用于存放每个处理器的产物。仅向上级返回完成摘要。
4. 提交并解决
提交更改,将待办事项标记为已解决,并推送到远程仓库。
关卡:停止。确认待办事项已解决且更改已提交,然后再继续。
5. 总结经验教训
加载 ce:compound 技能,记录经验。解决待办事项时,常会发现值得记录的模式和架构洞见。
关卡:停止。确认 compound 技能已在 docs/solutions/ 中生成解决方案文档。如果没有(用户拒绝或没有可总结的经验),则继续。
6. 清理
从这两个路径中删除已完成/已解决的待办事项文件。如果创建了 .context/compound-engineering/todo-resolve/<run-id>/ 临时目录,则将其删除(除非用户要求查看)。
Todos resolved: [count]
Pending (skipped): [count, or "none"]
Lessons documented: [path to solution doc, or "skipped"]
Todos cleaned up: [count deleted]
如果跳过了 pending 待办事项,请列出:
Skipped pending todos (run /todo-triage to approve):
- 003-pending-p2-missing-index.md
- 005-pending-p3-rename-variable.md