SuperAPI AI 工具集

synthesis-anti-shortcuts

编程与开发

查看项目

更新于 10-22 16:15

技能介绍

用途

Synthesis Anti-Shortcuts 用于捕捉一种特定的反模式:草稿看起来像优秀的工程工作,但在用户要求最佳解决方案后,悄悄替换成更低投入的路径,并用听起来合理的词汇(如“for now”“minimal diff”“backward compatible”“out of scope”)掩盖。该技能为这些“伪装”命名,并给出剥离它们的协议。

主要能力

该技能提供一套绑定规则(规则1至8承载方法论章节编号),核心包括:

  • 约束优先:在生成方案之前,先写下用户的目标与非目标(来自对话、项目上下文、工作区与全局指令);违反任一目标的方案不能出现。
  • 判断哪些约束起决定作用:只有当未解决的选择属于用户时才提问。“Recommendation: X. Your call?” 在已确定或已委托的选择上就是伪装;应执行并报告。
  • 扫描草稿与子代理报告中的伪装词汇:一个短语只有在用户要求针对其隐含内容进行优化时才是合法的。
  • 子代理派发卫生:派发简报要完整命名任务(不使用“keep changes minimal”“light touch”“surgical change”),最多携带五项交付物;派发前扫描子代理读取的每个字段;对子代理返回同样审计伪装,未完成的工作要重定向或完成,绝不传播延迟。
  • 响应前自检:在任何分析、建议或计划发送前运行自检。
  • 能力缺口不是护栏:绝不绕过护栏;遇到缺口时,命名失败的机制、列出替代方案并在报告前选择授权补救。
  • 扩充目录:生产输出中的新伪装会成为案例研究、目录条目,必要时成为扫描器模式。
  • 交付即完整性:完成有限任务,包括授权的交付;更多审计或框架不能替代交付物。

使用方式

技能包含多个参考文档,按需阅读:

  • references/methodology.md:完整模式、“Delivery is part of completeness”及方法论第1至8节。在会话中首次应用规则或案例不清晰时阅读。
  • references/costume-vocabulary.md:每个短语的分类、理由与替换框架。用于分类命中或重写伪装。
  • references/constraint-first-protocol.md:五步协议与一个完整示例。在多选项分析前阅读。
  • references/sub-agent-hygiene.md:派发与验收规则、简报模板、大小上限、派发前扫描。在派发或接受子代理前阅读。
  • references/case-studies.md:每个条目来源的事件;扫描器 see: 行指向此处。当命中的来源重要时阅读。
  • references/background.md:模式为何发生、各部分如何配合、兄弟技能、底层原则。每会话阅读一次。
  • costume-catalog.json:扫描器读取的短语目录(id、pattern、category、exemptions、rationale、rewrite)。当新伪装应自动触发时编辑它。
  • references/coverage-map.md:1.2.1 文本各部分及每个脚本改动现在所在的位置(裁决 D8)。
  • references/preserved.md:目录移出扫描器时被替换的句子,逐字保留。仅在审查变更时阅读。

扫描器:运行 python3 scripts/scan_output.py draft.md(或从标准输入读取文本),按类别打印每个命中:行与列、匹配短语、为何是捷径、重写框架以及 see: 案例。退出码 0 表示干净,1 表示检测到,2 表示错误。标志:--json、--quiet(仅退出码,用于钩子)、--context 120、--category <name>、--catalog <file>(JSON;YAML 需要 PyYAML)。它读取 costume-catalog.json 这个唯一公开目录,并跳过被引用或在代码中的短语,因为那些是在讨论而非使用。v5 Stop 钩子会根据同一目录的简短内置子集检查每条回复。

适用场景

  • 在生成任何非平凡的实现计划、设计建议或多选项分析之前
  • 在接受子代理报告之前,尤其是子代理自我标记权衡时
  • 在将文字提交到声誉攸关的公开产物之前(README、博客文章、营销文案、开源文档)
  • 当用户明确表示“complete this, no shortcuts”“best solution”或等价要求时,在响应之前
  • 作为任何涉及代码、内容或策略的草稿的响应前自检的一部分

限制

不适用于:

  • 实现显而易见的单行琐碎更改
  • 真正约束中立、确实需要用户输入的决定(如产品方向、日程安排、代理无法知道的利益相关者事实)
  • 代理在讨论捷径而非实施捷径的讨论(技能会识别引用和讨论模式的使用)

模式示例

技能中列出了七类伪装模式,包括:Backward compatible(避免更新消费者)、Minimal diff(半完成工作标为范围纪律)、Asking as shortcut(把约束决定的决定推回给用户)、Deferral(把实际工作推到未来会话)、Archive value(避免删除工作)、Dismissal(预测掉用户提出的担忧而非解决)、Scope excuse(避免修复正在修改的代码)。

响应前自检

在发送任何草稿分析、建议或实现计划之前:扫描草稿中全部七类伪装词汇;对每个匹配分类为真实约束或伪装;对每个伪装重写,重写要执行在真实目标上,而非更安全但偏离的重新框定;如果草稿以问题结尾,验证问题是约束中立的;然后才发送。