SuperAPI AI 工具集

constraint-driven-development

编程与开发

查看项目

更新于 10-25 02:04

技能介绍

Constraint-Driven Development 是一项面向 AI 代理协作开发的质量约束技能。其核心思想是:将项目“可交付”的质量标准以带数字的 CONSTRAINTS.md 文件形式固化到仓库根目录,让任何代理在任何工具链下都能读取并机械执行,而不是依赖易被忽略的散文式指导。

用途:当启动新项目或重要功能、用户要求“设置约束”“添加质量门禁”“定义标准”或“阻止代理交付垃圾”、代理产出量无人逐行审查、CI 检查存在但无人清楚哪些阻塞合并、覆盖率/性能/无障碍数字在 PR 中反复争论,或即将运行自主循环时,使用本技能。不适用于已有 CONSTRAINTS.md 且无需变更、一次性脚本/原型、仅需代码审查或构建 CI 管道、以及产品市场契合前预期寿命仅两周的代码。

主要能力:通过四步流程(检测现有配置、四问访谈、编写 CONSTRAINTS.md、为各维度安装工具并接入生命周期)建立质量底线。CONSTRAINTS.md 包含“Floor(始终强制)”“带数字的强制项”“已测量未强制”“例外”等表格,每行必须指明检查命令、运行时机和门禁条件。技能还提供默认阈值建议(如变更行覆盖率≥80%、LCP≤2500ms、CLS≤0.1、无障碍零严重问题、依赖漏洞无高危及以上),并强调使用棘轮机制(记录当前值,只允许不下降)。

使用方式:先检测语言栈、测试运行器、linter、覆盖率、CI 和代理工具链;然后依次询问四个问题(要强制哪些维度、失败时阻塞还是警告、是否有目标数字、可容忍的最慢检查时间),每个问题都有默认值;接着编写 CONSTRAINTS.md 并在 AGENTS.md 和 CLAUDE.md 中添加一行引用;再为选定维度安装对应工具(如 tsc、mypy、Semgrep、gitleaks、osv-scanner、Lighthouse、axe-core、dependency-cruiser、Stryker 等),并将检查命令映射到项目脚本(check:fast、check:task、check:full);最后将检查接入 BUILD、VERIFY、REVIEW、SHIP 各阶段,并遵循“按差异范围检查”“按成本决定位置”两条规则。技能还包含“守卫底线”步骤,通过 git diff 审查是否出现降低阈值、弱化测试、静默检查器、未完成工作或未讨论例外等行为,并提供参考实现 references/floor-guard.md。

适用场景:需要为 AI 代理驱动的开发项目建立可审计、可机械执行的质量门禁;在自主循环或批量生成代码时防止质量悄然下滑;在团队中统一覆盖率、性能、安全、无障碍等标准并减少 PR 争论。

限制:访谈需要真实用户交互,不能在 CI、/loop 或自主运行等非交互环境中执行;若约束缺失,只能应用 Floor 并标记待人工处理。Lighthouse 和 axe 需要运行中的 URL,不适用于 CLI、库或桌面应用。部分工具(如 Stryker、Semgrep 全仓库扫描)耗时较长,需按差异范围限定。技能不提供具体项目的收费、价格或效果保证,所有阈值和工具选择需结合项目实际情况调整。