用途:该技能管理 todos/ 目录下基于 Markdown 文件的待办跟踪系统,用于记录代码审查反馈、技术债、功能请求和工作项。适用于从发现或反馈创建待办、管理待办生命周期(pending→ready→complete)、分诊待审批项、检查依赖、将 PR 评论或代码发现转为跟踪工作,以及执行期间更新工作日志。
文件命名:{issue_id}-{status}-{priority}-{description}.md。issue_id 为顺序编号(001、002…)且不复用;status 为 pending(待分诊)、ready(已批准)、complete(完成);priority 为 p1(关键)、p2(重要)、p3(可选);description 用 kebab-case 简短描述。
文件结构:每个待办为带 YAML frontmatter 和结构化章节的 Markdown 文件,以 todo-template.md 为起点。必需章节包括问题陈述、发现、建议方案、推荐行动、验收标准、工作日志;可选章节有技术细节、资源、备注。frontmatter 字段含 status、priority、issue_id、tags、dependencies。
主要工作流:创建待办时先确定下一个 issue ID,复制模板并填写必需章节,添加初始工作日志,确定状态并加标签。分诊时列出 pending 项,阅读问题陈述与发现,决定批准、推迟或调整优先级;批准后重命名文件并更新 frontmatter,填写推荐行动。依赖通过 dependencies 字段声明,可用 grep 检查阻塞关系。执行时添加工作日志条目,记录日期、操作与学习。完成时核对验收标准、更新日志、重命名文件并更新状态。
限制与区分:该技能针对 todos/ 目录的独立 Markdown 文件系统,不同于应用内的 Rails Todo 数据库模型,也不同于仅在会话内存中跟踪的 TodoWrite 工具。资料未提供具体安装命令、收费或平台信息。