1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | constraint-driven-development-addyosmani-agent-skills |
| 作者/维护者 | Addy Osmani（个人开发者，Google Chrome 团队工程负责人） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/constraint-driven-development |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars / Forks | 合集仓库整体 94,873 / 10,067（GitHub API）；该数字属整个 25 子技能合集，不代表本技能自身热度 |
| 最新版本 | 无独立版本号，跟随合集仓库发布节奏；本技能最近一次内容更新为 2026-08-28（GitHub 提交历史） |
| 安装方式 | npx skills add addyosmani/agent-skills --skill constraint-driven-development，或直接复制 SKILL.md 到对应 agent 的 skills 目录 |
2. 功能介绍与亮点
该技能把项目质量标准从口头共识变成写在 CONSTRAINTS.md 里的机器可读契约：先扫描项目语言、测试、Lint、CI 配置，提四个带默认值的问题（强制哪些维度、拦截还是警告、测量现状还是直接定目标、检查多慢），生成含地板规则（禁抑制注释、桩代码、无理由跳测）与分维度门槛表的文件；再附参考脚本，在 diff 里侦测门槛调低、测试被删、断言抽掉、检查器静默、私加例外五种“agent 悄悄放水”手法。
不发明新工具，只为各维度指向既有事实标准工具（tsc、eslint、gitleaks、semgrep、Lighthouse、axe-core等），并给出棘轮机制（先测现状、只许变好不许变差）解决没有目标数字的冷启动难题。
3. 适用场景
固定分类：工程效率与代码质量。
适用于让 AI agent 自主写大量代码、无人逐行审阅的团队或个人开发者：质量红线没写下来、CI 检查项混乱、或已发现 agent 靠跳测试、加抑制注释让检查变绿；也适用于启用自主编码循环前先钉死“什么算达标”。
4. 跨 Agent 兼容性
- Claude Code：原生支持——合集仓库为其提供
/constraints专用斜杠命令 - Codex / OpenClaw / Hermes Agent：需适配——三者均在推荐安装器
vercel-labs/skills官方支持列表内，写入标准目录后可加载，无专属命令
5. 推荐理由
多数同类技能只教“好代码长什么样”，这个把标准落成能机械核查的契约，专治“agent 产出量远超人工审阅速度”——棘轮机制解决冷启动无基线，diff 侦测解决“检查被悄悄绕过”，文档详尽、配套工具全免费。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 未查到该子技能自身的具名第三方评价；仅在两个第三方 skill 目录站（atskills.one、skills.sh）被收录索引，以及在另一个开源技能追踪项目中出现一条自动化收录记录，证据薄弱但非零 |
| 可用性 | 9 | 复制/命令安装即用；文档含完整示例配置与脚本；最近一次内容更新在近一个月内；全部推荐工具均为免费开源 |
| 安全性 | 9 | 技能主体为交互式访谈与文档生成，不自行执行代码；附带的参考脚本仅本地读取 git diff，无网络外发，公开可审计；作者身份可查证、无造假迹象；License 明确 |
检查清单：①参考脚本仅读 git diff ②无联网外发 ③不涉及 API Key ④未见可疑指令 ⑤作者身份可核实无造假 ⑥License 明确 ⑦近一月有更新。
综合评分：8.0。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| bigquery-pipeline-audit（github/awesome-copilot） | 审计 BigQuery 数据管线的成本与幂等性 | 聚焦单一数据平台的运维审计，不涉及通用代码质量契约 |
| build-evidence-map（github/awesome-copilot） | 为有争议的技术决策构建可审计证据图谱 | 面向“决策留痕”，不产出可机械执行的质量门槛 |
| doublecheck（github/awesome-copilot） | 三层事实核验流水线，核查 AI 输出内容 | 面向内容事实性校验，不涉及代码质量或测试覆盖率 |
| code-review-and-quality（同仓库姊妹技能） | 提供五轴代码评审标准 | 侧重“评审时怎么看”，是一次性判断；本技能负责“标准写成什么、如何持续机械核查”，二者互补而非替代 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，仅在两个 skill 目录聚合站上被收录索引。
9. 其他补充
访谈环节复用了同仓库 interview-me 的“一次一问、带默认值”交互模式。
10. 安装使用方式
- 安装器（支持 70+ 目标 agent）：
npx skills add addyosmani/agent-skills --skill constraint-driven-development - 或手动复制
skills/constraint-driven-development/目录到所用 agent 的 skills 目录 - 无需重启，提及“设置质量门槛”或“set up constraints”即触发，先扫描现状再问四题并生成
CONSTRAINTS.md
11. 注意事项
- 访谈需真人在场，不适合无人值守的 CI 或自动循环，此时退化为只套默认地板规则
- 可访问性、性能两维度需要可访问的预览地址，纯 CLI/库类项目无法启用
- 随附脚本仅用正则识别常见抑制注释与桩代码，高度混淆的绕过手法需升级第三方门禁工具