Back to Details

todo-resolve

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Resolve approved todos using parallel processing, document lessons learned, then clean up.
Only 
ready
todos are resolved. 
pending
todos are skipped — they haven't been triaged yet. If pending todos exist, list them at the end so the user knows what was left behind.
通过并行处理解决已获批的待办事项，记录经验教训，然后进行清理。
仅处理
ready
状态的待办事项。
pending
状态的待办事项会被跳过——它们尚未完成分类。如果存在pending状态的待办事项，需在末尾列出，以便用户了解未处理的内容。

Workflow

工作流

1. Analyze

1. 分析

Scan 
.context/compound-engineering/todos/*.md
and legacy 
todos/*.md
. Partition by status:
  • ready
     (status field or 
    -ready-
    in filename): resolve these.
  • pending
    : skip. Report them at the end.
  • complete
    : ignore, already done.
If a specific todo ID or pattern was passed as an argument, filter to matching todos only (still must be 
ready
).
Residual actionable work from 
ce:review mode:autofix
after its 
safe_auto
pass will already be 
ready
.
Skip any todo that recommends deleting, removing, or gitignoring files in 
docs/brainstorms/
, 
docs/plans/
, or 
docs/solutions/
— these are intentional pipeline artifacts.
扫描
.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. Plan

2. 规划

Create a task list grouped by type (e.g., 
TaskCreate
in Claude Code, 
update_plan
in Codex). Analyze dependencies -- items that others depend on run first. Output a mermaid diagram showing execution order and parallelism.
创建按类型分组的任务列表（例如Claude Code中的
TaskCreate
，Codex中的
update_plan
）。分析依赖关系——优先执行被其他任务依赖的项。输出显示执行顺序和并行性的Mermaid图。

3. Implement (PARALLEL)

3. 执行（并行）

Spawn a 
compound-engineering:workflow:pr-comment-resolver
agent per item. Prefer parallel; fall back to sequential respecting dependency order.
Batching: 1-4 items: direct parallel returns. 5+ items: batches of 4, each returning only a short status summary (todo handled, files changed, tests run/skipped, blockers).
For large sets, use a scratch directory at 
.context/compound-engineering/todo-resolve/<run-id>/
for per-resolver artifacts. Return only completion summaries to parent.
为每个任务启动一个
compound-engineering:workflow:pr-comment-resolver
Agent。优先使用并行处理；若有依赖关系，则按顺序执行。
批量处理规则：1-4个任务：直接并行返回结果。5个及以上任务：每4个为一批，每批仅返回简短状态摘要（待办事项处理情况、修改的文件、运行/跳过的测试、阻塞问题）。
对于大规模任务集，在
.context/compound-engineering/todo-resolve/<run-id>/
目录下创建临时目录，用于存储每个 resolver 的产物。仅向父进程返回完成摘要。

4. Commit & Resolve

4. 提交与标记完成

Commit changes, mark todos resolved, push to remote.
GATE: STOP. Verify todos resolved and changes committed before proceeding.
提交修改，标记待办事项为已解决，推送到远程仓库。
检查点：停止操作。在继续前验证待办事项已解决且修改已提交。

5. Compound on Lessons Learned

5. 总结经验教训

Load the 
ce:compound
skill to document what was learned. Todo resolutions often surface patterns and architectural insights worth capturing.
GATE: STOP. Verify the compound skill produced a solution document in 
docs/solutions/
. If none (user declined or no learnings), continue.
加载
ce:compound
技能来记录所学到的内容。解决待办事项通常会发现值得记录的模式和架构见解。
检查点：停止操作。验证compound技能是否在
docs/solutions/
目录下生成了解决方案文档。如果未生成（用户拒绝或无经验可总结），则继续。

6. Clean Up

6. 清理

Delete completed/resolved todo files from both paths. If a scratch directory was created at 
.context/compound-engineering/todo-resolve/<run-id>/
, delete it (unless user asked to inspect).
Todos resolved: [count]
Pending (skipped): [count, or "none"]
Lessons documented: [path to solution doc, or "skipped"]
Todos cleaned up: [count deleted]
If pending todos were skipped, list them:
Skipped pending todos (run /todo-triage to approve):
  - 003-pending-p2-missing-index.md
  - 005-pending-p3-rename-variable.md
从两个路径中删除已完成/已解决的待办事项文件。如果创建了临时目录
.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