SuperAPI AI 工具集

trellis-plan-review

智能体与模型

查看项目

更新于 10-15 20:05

技能介绍

用途:对 Trellis 任务规划产物做独立审查。把选定任务及其递归的当前或归档子任务视为同一审查范围,核对规划文档中的断言、事实与推论、验收标准(AC)追溯、量化论证、内部矛盾、判据确定性与实现漂移,并输出一份合并报告与交接提示词。

主要能力:先定位根任务(读取 task.json),再解析审查范围(根任务加 children 递归闭包,按顺序解析,叶子为单成员范围)。Pass 0 用脚本做机械预检:树成员与完整性、各成员产物是否存在、模板占位符残留、path:line 引用解析、R/AC 标识交叉引用,以及根报告目标是否被 git 忽略或跟踪(仅提示,不阻断)。Pass 1–7 做判断:断言核对、事实与推论、AC 追溯(按子句而非按 AC 拆分)、量化论证、内部矛盾、判据确定性、实现漂移(状态非 planning 时适用)。每条发现必须附证据,无法引用者丢弃。

使用方式:命令中 <skill-dir> 为占位符,需替换为技能加载时公布的实际目录;python 不在 PATH 时用 py -3。预检:python "<skill-dir>/scripts/plan_precheck.py" <root-task-dir> --include-descendants(默认输出聚合 JSON,需持久化诊断时用 --output <path>,不要用 > 重定向)。写报告:python "<skill-dir>/scripts/write_review_report.py" <root-task-dir> --input <filled-report.md>(Windows 优先 --input,helper 自行写文件,不要重定向)。报告写入被审查项目的 .trellis/reviews/<root-task-name>.md。

限制:不得编辑 prd.md、design.md、implement.md、*.jsonl、task.json 或产品代码;不得修复发现的缺陷或产出修订计划;唯一允许的持久写入是 .trellis/reviews/ 下的一份审查报告或临时 --input 文件;不得运行 task.py start、task.py finish 或任何写入状态的 Trellis 命令;一个审查范围只产出一份合并报告和一个交接提示词,不删除、覆盖或迁移历史子报告;子任务缺失、歧义、元数据畸形、循环、重复边/成员、不安全路径或父链接错误时在判断前失败关闭。报告语言跟随请求与讨论语言,文件路径、标识符、命令与代码片段保持原样。

适用场景:审查 Trellis 规划产物质量、核对规划与实现一致性。单独审查代码 diff 应改用 code-auditor 或 code-quality-review;诊断欠明确任务或列出未知项用 unknowns-first;编写、修复或执行计划用项目自身的 Trellis 规划与执行流程。