SuperAPI AI 工具集

intent-critique

编程与开发

查看项目

更新于 10-15 17:17

技能介绍

用途:对 Intent 文档进行设计质量批判性审查,不检查格式,只回答“这个设计能否更简单”。

主要能力:按过度设计、YAGNI、过早抽象、边界问题、隐藏复杂度等维度扫描;发现缺失内容时输出 gap flag 而不直接填充。修改达 3 次时自动触发 Convergence Check,包含 Anchor 追溯、实现匹配、约束与分析的区分、与子 Intent 去重。还可启动无当前讨论上下文的 Devil's Advocate 子代理独立评估,并读取 records/INDEX.md 获得完整决策上下文。

使用方式: /intent-critique [path] /intent-critique /intent-critique --dry-run 流程为先记录初始行数(wc -l INTENT.md,记为 before_lines),逐维度分析,对每个发现用 AskUserQuestion 与用户讨论(接受简化、保留原设计、跳过),汇总报告,可选更新 Intent,最后再次 wc -l 验证净减(after_lines)。若 after_lines > before_lines 则拒绝保存并回滚。完整报告保存到 records/critique-{date}.md 并更新 records/INDEX.md。

核心约束:Anti-Accretion Rule,审查后总行数必须 ≤ 之前,属硬约束。只允许删除、合并、拆分、简化四种操作;禁止引入新概念或新 section、添加新分析框架、扩展已有 section 范围。如确需新增,须先删除等量或更多旧内容、用户明确同意,且最终行数仍 ≤ 初始行数。

适用场景:希望在 intent-interview → intent-validate → intent-critique → intent-review 流程中独立反思设计、消除冗余与过度设计时使用,可随时单独调用。

限制:不检查格式(intent-validate 职责)、不检查一致性(intent-sync 职责)、不标记审批状态(intent-review 职责)、不自动做决定,必须与用户讨论。