用途:triage 是 gate-plan 之前的生命周期步骤,负责把候选工作项变成 QUEUE.md 行。它防止的失败是:在整体形态仍模糊时把工作范围收窄到最近可见的一步,并让这一窄范围在下游固化为架构。
主要能力:先以 slug 命名脚手架生成 why 草稿(不占用 Q 编号),再引导操作者从近期步骤向上追问“为了什么”,直到答案变模糊,从而记录方向、未确定项(fuzz)、有意识的范围取舍(carve)和重访触发点。随后由独立评审脚本做冷评审,只读取草稿路径,输出 JSON(confidence 1–4、各探针发现、blocking_deficiencies、l3_residue、verdict)。仅当 confidence 为 4 且无阻塞缺陷时 PASS,否则 FAIL 并需修订后重跑。PASS 后才提交:计算 max(Q[0-9]+)+1,重命名草稿为 Q{n}-why.md,写入 Frozen 时间戳,并生成 QUEUE.md 行存根。
使用方式:在工作区根目录运行 node ${CLAUDE_PLUGIN_ROOT}/skills/triage/scripts/next-q.mjs scaffold 生成草稿;冷评审运行 NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" bun ${CLAUDE_PLUGIN_ROOT}/skills/triage/scripts/cold-review.ts <草稿绝对路径>;PASS 后运行 node ${CLAUDE_PLUGIN_ROOT}/skills/triage/scripts/next-q.mjs commit --draft <草稿绝对路径>。
限制:冷评审脚本失败(缺运行时、缺凭据、模型错误)时非零退出,必须停止,不得伪造结论或退回上下文内评审。编号只分配一次、允许不连续。评审依赖由 SessionStart 钩子安装,并需要 Pi 配置的凭据。具体模型与凭据细节见 ADR-002,资料未提供更多收费或平台信息。