用途:triage 是 CLI 待办系统中的一个分诊命令,用于把待办目录 todos/ 中的条目逐条呈现并分类,帮助决定哪些条目应被纳入待办系统跟踪。资料说明该命令适用于待办代码审查发现、处理安全审计结果、审查性能分析,以及处理其他需要跟踪的分类发现。
主要能力:读取 todos/ 中全部待处理条目,逐条展示;每条以固定格式呈现,包括标题、严重级别、类别、描述、位置、问题场景、建议方案与预估工作量;用户对每条选择 yes、next 或 custom;选择后自动处理文件。
使用方式:分诊过程分四步。第一步逐条展示发现;第二步处理用户决策;第三步持续到全部处理完毕;第四步给出总结。选择 yes 时,若文件已存在则从 {id}-pending-{priority}-{desc}.md 重命名为 {id}-ready-{priority}-{desc}.md,并把 YAML frontmatter 中 status 由 pending 改为 ready;若新建则使用 {next_id}-ready-{priority}-{brief-description}.md,优先级映射为 P1→p1、P2→p2、P3→p3。选择 next 时删除该待办文件并跳过;选择 custom 时先询问修改内容,再重新确认。完成后可运行 ls todos/-ready-.md 查看已就绪条目,或用 /resolve-todo-parallel 处理多个已批准条目。
限制:资料明确要求分诊期间不要编写任何代码,不实现修复,也不添加详细实现细节,这些留给后续解决阶段。分诊命令仅做呈现、决策与待办文件的状态更新。