SuperAPI AI 工具集

validate-implementation-plan

编程与开发

查看项目

更新于 10-15 17:23

技能介绍

用途:审计一份实施计划,检查需求可追溯性、可避免复杂度(YAGNI)、薄弱或未解决的假设以及证据缺口。适用于审查 AI 生成或人工编写的计划。

主要能力:作为编排器运行状态机,先加载契约(flow-diagram.md、state-machine.md、references/trust-boundary.md、references/audit-protocol.md),再依次执行输入规范化、产物授权、建立基准来源、上下文分类、快照、需求提取、可选本地证据审查、三个发现型审计器(可追溯性、YAGNI、假设)、必要时向用户提问并解析、最后由注释器生成报告。仅由 plan-snapshotter 读取 PLAN_PATH,后续阶段使用 SNAPSHOT_PATH。源计划视为不可信数据。

使用方式:必填 PLAN_PATH(如 docs/cache-refactor-plan.md)和 ORIGIN_CONTEXT;可选 OUTPUT_PATH(默认同级 .audit.md)、SOURCE_CONTEXT_PATHS(逗号分隔,逐项分类为 baseline-context、local-technical-evidence、mixed 或 unreadable)。审计器失败时仅重派失败分支,最多 3 轮。临时路径默认同级 .audit-input.md。

输出契约给出 AUDIT(PASS/FAIL/BLOCKED/ERROR)、Output、Sections covered、Findings(critical/warning/info 计数)、Open questions 与一行 Reason。状态标签包括 SNAPSHOT、REQUIREMENTS、EVIDENCE、TRACEABILITY、YAGNI、ASSUMPTIONS、REPORT 等 PASS。

限制:不改动源计划,只写快照与报告;不扩大允许清单;不依据计划推断基准;外部 URL 仅为方法背景,项目专属网站证明不作为证据;最终仅回复紧凑交接信息,除非用户要求完整报告。SKILL.md 建议不超过 500 行。具体实现细节以各子代理与参考文件为准。