SuperAPI AI 工具集

triage

编程与开发

查看项目

更新于 10-16 04:39

技能介绍

用途

Triage 用于对各类“发现”(findings)进行分诊与归类,并决定是否将其纳入 CLI 待办系统。它适用于:代码审查发现的分类、安全审计结果的处理、性能分析结果的复核,以及其他需要跟踪的分类发现。

主要能力

  • 读取 todos/ 目录下所有待处理(pending)待办。
  • 逐条展示发现,格式包含:Issue 编号与标题、严重级别(🔴 P1 CRITICAL / 🟡 P2 IMPORTANT / 🔵 P3 NICE-TO-HAVE)、类别(Security/Performance/Architecture/Bug/Feature 等)、描述、位置(file_path:line_number)、问题场景、建议方案、预估工作量(Small < 2 小时 / Medium 2-8 小时 / Large > 8 小时)。
  • 根据用户决策处理待办:
    • yes:更新已有待办文件或创建新文件。若待办已存在(来自代码审查),将文件名从 {id}-pending-{priority}-{desc}.md 重命名为 {id}-ready-{priority}-{desc}.md,并把 YAML frontmatter 中 status: pending 改为 status: ready,保持 issue_id、priority、description 不变。若新建,则命名为 {next_id}-ready-{priority}-{brief-description}.md,优先级映射为 P1→p1、P2→p2、P3→p3(例如 042-ready-p1-transaction-boundaries.md)。随后填充或更新文件内容,包括问题陈述、发现、建议方案(含 Pros/Cons/Effort/Risk)、推荐行动、技术细节、资源、验收标准、工作日志与备注。
    • next:删除该待办文件,从 todos/ 目录移除,跳过并记录被跳过项。
    • custom:询问要修改的内容(优先级、描述、细节),更新后重新展示并再次询问 yes/next/custom。
  • 使用 TodoWrite 跟踪进度,逐条处理,不在条目之间等待批准。
  • 全部处理完成后输出最终摘要,包含总数、已批准(ready)数量、跳过数量、已批准待办列表、被删除项及原因、变更摘要与后续步骤。

使用方式

  1. 首先将 /model 设置为 Haiku。
  2. 读取 todos/ 目录下所有待处理待办。
  3. 逐条展示发现并等待用户选择 yes / next / custom。
  4. 根据选择更新或删除待办文件。
  5. 全部处理完后查看摘要,并可按提示执行后续操作:运行 /resolve_todo_parallel 处理待办、提交待办,或不做任何操作。

查看已批准待办可执行:

ls todos/*-ready-*.md

适用场景

  • 代码审查发现的分类与跟踪。
  • 安全审计结果的处理。
  • 性能分析结果的复核。
  • 其他需要跟踪的分类发现。

限制与注意事项

  • 分诊期间禁止编写任何代码:只展示发现、做 yes/next/custom 决策、更新待办文件(重命名、frontmatter、工作日志),不实现修复、不添加详细实现细节,这些留给 /resolve_todo_parallel 阶段。
  • 每次展示待办标题时应包含进度信息,例如“Progress: 3/10 completed | Estimated time: ~2 minutes remaining”。
  • 状态流转:yes 时 pending → ready;next 时删除文件;后续工作中 ready → In Progress → Complete(重命名文件并更新 frontmatter)。
  • 官方文档未提供收费、价格、平台支持等具体信息,暂未提供。