用途:在 todos/ 目录中管理基于文件的待办跟踪系统,用于记录代码评审反馈、技术债、功能请求和工作项。每个待办是一个带 YAML frontmatter 和结构化章节的 Markdown 文件。适用场景包括从发现或反馈创建待办、管理待办生命周期(pending → ready → complete)、对 pending 项进行分诊审批、检查与管理依赖、把 PR 评论或代码发现转为跟踪工作,以及执行待办时更新工作日志。
主要能力:文件命名遵循 {issue_id}-{status}-{priority}-{description}.md;issue_id 为顺序编号且不复用;status 为 pending/ready/complete;priority 为 p1/p2/p3;description 用 kebab-case。文件结构含 Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log 等必要章节,可选 Technical Details、Resources、Notes。YAML frontmatter 字段包括 status、priority、issue_id、tags、dependencies。
使用方式:创建待办时先确定下一个 issue ID,再复制模板 assets/todo-template.md 到 todos/ 并填写章节、添加工作日志与标签。分诊时列出 todos/-pending-.md,审阅后重命名并更新 frontmatter 与 Recommended Action,可用 /triage。依赖用 dependencies 字段记录,并通过 grep 命令检查阻塞关系。完成时核对验收标准、更新工作日志、重命名文件并更新状态。常用命令如 ls todos/、grep -l 'dependencies: []' todos/-ready-p1-.md、for dep in 001 002 003; do [ -f "todos/${dep}-complete-*.md" ] || echo "Issue $dep not complete"; done。