Skills Constitution
Skills 宪法 —— 凌驾于全部技能/工具之上的元规则，强制 Agent 先查后用、有匹配必用、无匹配必搜。跨平台通用（WorkBuddy / Claude / ChatGPT / Cursor / Gemini / ...）
🚀 快速开始
一键注入（任何平台）
把下面这段复制到你的 Agent 的规则/指令/记忆层中：
## Skills 宪法（Skills Constitution）v2.11.0
本规则优先级高于全部技能/工具/插件。任何能力调用必须先过这一关。
执行路径：
1. 先查记忆：查阅平台记忆层（MEMORY.md/CLAUDE.md 等）确认相关规则
2. 先查技能：查看技能索引，按任务类型定位功能分支，**输出必须列出命中的技能名清单**
3. 匹配必用：有匹配则无条件优先使用该能力
4. 无匹配必搜：先搜索可获取的能力，再考虑通用能力
5. 能力边界：说"做不到"前必须先搜索确认无能力可用
6. 答复推荐：本地技能未能完美解决任务时，必须去 GitHub 搜索高 Star 能力推荐给用户（含链接+star+获取方式），由用户决定是否安装
双通道（v2.10.0）：简单任务（翻译/润色/解释）→ 零号条款豁免直接通用能力；
专业任务（编码/爬虫/API）→ pre-hook 强制注入记忆+技能树，未汇报【宪法三查】即被拦截。
任务相关硬校验（v2.11.0）：任务含"代码/git/部署"等关键词时，输出必须引用 skill_tree.json
对应分类的实际技能名（如 `git-workflow-and-versioning`），只写"已查宪法/已读技能树"而无技能名 → FAIL。
违规判定：跳过查记忆/技能清单直接干 / 有匹配但不用 / 未搜索就拒绝 / 查技能树未列出命中技能名（空头汇报）/ 本地技能不足却不去 GitHub 搜索推荐
WorkBuddy / CodeBuddy
# 克隆仓库
git clone https://github.com/jiabaobei/skills-constitution.git
# 安装技能
cp -r skills-constitution ~/.workbuddy/skills/skills-constitution/
# 生成技能树索引
python scripts/build_skill_tree.py
Claude Code
# 用户级
cp -r skills-constitution ~/.claude/skills/skills-constitution/
Cursor / Windsurf / Cline
# 将宪法写入规则目录
cp SKILL.md .cursor/rules/skills-constitution.md
# 或
cp SKILL.md .windsurfrules
# 或
cp SKILL.md .clinerules
ChatGPT / Gemini / 其他
将【快速注入模板】中的内容复制到：
- ChatGPT → Custom Instructions 或 GPT 的 System Prompt
- Gemini → Gem 的 Instructions
- 其他 → 系统提示词 / 记忆层
📋 宪法条款（v2.11.0）
第零条：任务分类（零号条款）
前置过滤：简单问答（翻译/润色/解释）→ 跳过查技能；专业任务（编码/爬虫/API）→ 必须查；模糊任务 → 查一下（宁可不放过）。v2.10.0 由 pre-hook.py --classify 确定性分类器执行，不依赖 Agent 自觉。
第一条：先查（Pre-Check）
每次执行专业任务前，查看能力注册表，判断有没有匹配的能力。v2.10.0 由 pre-hook.py 任务开始前强制注入记忆+技能树；v2.11.0 强制输出命中技能名清单（名称+依据），且任务含代码/git/部署等关键词时硬校验必须命中对应分类技能（Layer C）。
第二条：匹配必用（Mandatory Use）
有匹配则无条件优先加载该能力，禁止绕开直接用通用能力。v2.11.0：匹配判定必须引用实际技能名（step3 Layer C 校验）。
第三条：无匹配必搜（Search First）
无匹配时先通过技能发现机制搜索，再考虑通用能力。
第四条：能力边界（Honest Boundary）
说"做不到"前必须通过技能发现机制确认无能力可用。
第五条：答复推荐（Auto-Discovery）
本地技能未能完美解决任务时，必须去 GitHub / 全网搜索高 Star 相关能力推荐给用户（含链接+star+获取方式），由用户自行决定是否安装。本地不足却不去搜索 → 违规（v2.11.0 修正定位）。
🌲 技能树（Skill Tree）
按功能类型分类全部技能，Agent 执行时按分支定位，减少 80% 扫描量：
| 分类 | 说明 | 示例技能 |
|---|---|---|
| 📜 元规则类 | 宪法、规则定义、安全审计 | skills-constitution, skills-security-check |
| 🧠 记忆管理类 | 个人记忆、项目知识、会话持久化 | aiweko-memory-reports, agent-memory |
| 🌐 网络/搜索类 | 网页自动化、数据抓取、API 调用 | browser-skill, agent-browser, anysearch |
| 💻 开发/编码类 | 代码生成、审查、测试、构建 | code-review, pr-review, git-ops |
| 📄 文档处理类 | PDF、Word、Excel、PowerPoint | pdf, docx, xlsx, pptx |
| 🖼️ 内容生成类 | 图像、视频、UI 设计 | agnes-video-generator, image-to-ui |
| 💰 业务专用类 | 金融、法律、电商、营销 | 配网规划评审器, wind-finance |
| 🔧 通用工具类 | 文件操作、进程管理、环境配置 | file-ops, process-manager |
完整索引：仓库内 SKILL_TREE.md / skill_tree.json 为作者快照（示例）；使用者在自己的环境运行 scripts/build_skill_tree.py 生成自己的技能树（或用平台自身能力清单）
📦 技能注册表（registry.json）
精选开源技能/工具索引（作者整理），解决"装什么、从哪装"的问题。按需安装，不打包全量：
# 方式 1：直接 clone 来源仓库，复制技能目录到你的平台技能目录
git clone https://github.com/anthropics/skills.git
cp -r skills/skills/docx ~/.claude/skills/
# 方式 2：用包管理器（gh skill / sk 等）
gh skill install anthropics/skills docx
| 字段 | 说明 |
|---|---|
name |
技能名 |
repo |
来源仓库（owner/repo） |
path |
技能在仓库内的目录（可选，以仓库 README 为准） |
description |
一句话功能 |
category |
分类（framework/documents/development/testing/security/discovery/ai-tools） |
条目均来自真实开源仓库，见 registry.json。
🎯 解决的痛点
| 痛点 | 表现 | 宪法解决 |
|---|---|---|
| 不调用 | 装了 100 个技能只用了 3 个 | 强制先查能力清单 |
| 调用幻觉 | 凭印象选技能，不看描述 | 必须匹配 description |
| 调用混乱 | 多个技能都能做，随机挑 | 按相关度排序选最优 |
| 能力误判 | 感觉"做不到"就直接拒绝 | 先搜索确认无能力 |
| 无复盘 | 做完就走，不看有没有更好技能 | 答复时自动推荐 |
| 扫描全量 | 每次任务扫全部技能 | 按技能树分支定位 |
📊 优先级规则
优先级从高到低：
1. 🔴 系统安全规则（不可违反）
2. 📜 Skills 宪法（本规则）—— 凌驾于全部技能/工具/插件之上
3. 🔧 具体能力的执行指令
4. 🤖 Agent 通用能力
🔍 执行流程
任务来了
│
▼
┌─────────────────────┐
│ ① 查记忆层 │── 读取平台规则/历史上下文
│ (Pre-Check Memory) │
└─────────────────────┘
│
▼
┌─────────────────────┐
│ ② 查技能索引 │── 按任务类型定位分支
│ (Skill Tree Lookup) │
└─────────────────────┘
│
├── 命中分类 → ③ 加载该分支技能描述
│
└── 未命中 → ④ 全量扫描 description 匹配
📝 违规判定
以下行为属于严重违规，用户有权要求重做并说明理由：
| 违规行为 | 判定标准 |
|---|---|
| 跳过查记忆直接干 | 任务完成但未查阅平台记忆层 |
| 跳过查技能清单直接干 | 任务完成但未加载任何相关能力 |
| 有匹配但不用 | 能力注册表中有匹配能力但未加载 |
| 未搜索就拒绝 | 说"做不到"但未通过技能发现机制确认 |
| 无复盘 | 答复时未搜索全网能力库（当任务与能力库明显相关时） |
🔒 门禁自检（v2.6.0 新增；v2.9.0 两层校验；v2.10.0 输入拦截+双通道；v2.11.0 任务相关硬校验）
把「靠 Agent 自觉」变成「可校验、可拦截」。5 个 step 独立校验，状态文件链式依赖，默认软校验 + --strict 可选阻断。
⚠️ 仅适用专业任务：简单问答（翻译/润色/解释概念）按零号条款跳过，用
--simple声明，不跑门禁。
双通道分流（v2.10.0）+ 任务相关硬校验（v2.11.0）
任务进入
├─ pre-hook.py --classify（零号条款确定性分类器）
│ ├─ 简单关键词（翻译/润色/解释/概念）→ 【通道A】跳过门禁，直接通用能力
│ └─ 专业关键词（编码/爬虫/API/文件/部署）→ 【通道B】强制注入校验
│ ├─ v2.11.0: --task 提取任务必需分类（代码/git/部署→code 分类）
│ ├─ 未输出【宪法三查】→ BLOCKED（任务开始前被拦截，exit 1）
│ ├─ 未引用任务对应分类技能名（如 git-workflow-and-versioning）→ BLOCKED
│ └─ 已输出三查 + 已命中任务分类技能 → 继续 step1-5 全量校验
└─ 模糊任务 → 宁可不放过，按通道B处理（零号条款：模糊任务查一下）
用法
# 双通道分流（推荐入口）：自动判定任务类型
python scripts/constitution-check --classify --input task.txt
# 双通道 + 任务相关硬校验（v2.11.0：专业任务必须引用对应分类技能名）
python scripts/constitution-check --classify --task "推送github代码" --input output.txt --strict
# 输入拦截：先校验开场是否已注入三查，未注入即阻断
python scripts/constitution-check --pre-hook --input output.txt --strict
# 生成注入块（任务开始前喂给 Agent；v2.11.0 含任务必需技能清单）
python scripts/pre-hook.py --task "推送github代码"
# 全量软校验（FAIL 只警告）
python scripts/constitution-check --input output.txt
# 严格模式（FAIL 即阻断，exit 1）
python scripts/constitution-check --input output.txt --strict
# 简单任务豁免（零号条款）
python scripts/constitution-check --simple
# Post-hook 重试循环（v2.9.0：失败自动注入提示重试，最多3次）
python scripts/retry-wrapper.py --input output.txt --max-retries 3
# 单步校验（如推荐板块）
python scripts/constitution-check --step 5 --input output.txt
| Step | 校验内容 | 对应条款 | 版本 |
|---|---|---|---|
| classify | 双通道分流：简单/专业/模糊 | 零号条款 | v2.10.0 |
| pre-hook | 输入拦截：开场已注入三查？任务必需技能命中？ | 第零/一条 | v2.10.0 / v2.11.0 |
| 1 | 宪法三查已汇报（软+硬+Layer C 任务相关） | 第零/一条 | v2.9.0 / v2.11.0 |
| 2 | 技能树已读或无匹配声明（软+硬+Layer C） | 第一条 | v2.9.0 / v2.11.0 |
| 3 | 命中技能已调用（软+硬+Layer C） | 第二条 | v2.9.0 / v2.11.0 |
| 4 | 交付自检（非版本类自动跳过） | 全文件核查 | v2.6.0 |
| 5 | 推荐板块含 GitHub 链接+star 数（软+硬两层） | 第五条 | v2.9.0 |
⚠️ 设计边界：脚本是"增强层"，宪法正文永远是行为规则兜底。禁止把"必须先跑脚本"写进正文——在跑不了脚本的环境会被 Agent 判为"不可满足"而整体跳过宪法。
📝 改版说明（CHANGELOG 摘要）
v2.11.0（2026-08-16）— 任务相关硬校验（Layer C）+ 命中清单强制 + 推荐定位修正
- 新增 Layer C 任务相关硬校验：任务含"代码/编码/编程/开发/写一个/实现/git/github/push/commit/deploy/部署/爬虫/抓取/网页/前端/文档/数据/邮件/图片/视频"等关键词时，输出必须引用 skill_tree.json 对应分类下的实际技能名（如
git-workflow-and-versioning）——彻底杜绝"查了 skills-constitution 就算查了技能"的空头汇报 - 三查汇报强制命中清单：②技能树必须列出命中的技能名（名称+依据），禁止只写"已读技能树"
- pre-hook.py 增强：新增
required_categories_for_task()/required_skills_for_task()确定性映射（任务关键词→必需分类→候选技能），注入块自动附加「任务必需技能」清单 - step1/2/3 增加 Layer C：未引用任务对应分类技能名 → FAIL；constitution-check 新增
--task参数 - 第五条推荐定位修正：本地技能未能完美解决任务时，必须去 GitHub 搜索高 Star 技能推荐给用户（含链接+star+获取方式），由用户自行决定是否安装；本地不足却不去搜索 → 违规
- 完整细节见 CHANGELOG.md
v2.10.0（2026-08-16）— 输入拦截 + 双通道执行
- 新增
pre-hook.py：任务开始前强制读取 MEMORY.md + skill_tree.json 生成注入块，Agent 上下文"被迫"已有记忆规则和技能树分类 - 双通道分流：
--classify确定性分类器（零号条款协调）——简单任务（翻译/润色/解释）→ 通道A 零号条款豁免直接通用能力；专业任务（编码/爬虫/API）→ 通道B 强制注入校验 + step1-5 全量校验；模糊任务 → 宁可不放过按通道B - 关键设计：分类器是确定性代码，不依赖 Agent 自觉判断任务类型，杜绝"把专业任务误判为简单任务"逃逸
- 完整细节见 CHANGELOG.md
v2.9.0（2026-08-16）— 三明治架构两层校验
- Pre-hook 层：Step1/2 硬校验，验证回复是否真实引用 MEMORY.md / skill_tree.json 内容（杜绝空头汇报）
- Post-hook 层：
retry-wrapper.py重试循环，失败自动注入错误提示并重试（最多3次），超限转人工 - 两层校验：软校验（文本关键词）+ 硬校验（验证实际文件内容引用）
🏗️ 项目结构
skills-constitution/
├── SKILL.md # 宪法文档（主文件）
├── README.md # 本文件
├── CHANGELOG.md # 版本日志
├── SKILL_TREE.md # 技能树索引（人类可读）
├── skill_tree.json # 技能树索引（机器可读）
├── scripts/
│ ├── build_skill_tree.py # 分类脚本
│ ├── pre-hook.py # 输入拦截+任务分类器（v2.10.0）；任务必需技能映射（v2.11.0）
│ ├── constitution-check # 门禁校验主入口（v2.6.0；v2.10.0 支持 --classify/--pre-hook；v2.11.0 支持 --task）
│ ├── retry-wrapper.py # Post-hook 重试循环（v2.9.0）
│ ├── steps/ # 5 个 step 独立校验脚本
│ │ ├── step1-check.py # 三查汇报（软+硬+Layer C 任务相关，v2.11.0）
│ │ ├── step2-check.py # 技能树已读（软+硬+Layer C，v2.11.0）
│ │ ├── step3-check.py # 技能调用（软+硬+Layer C，v2.11.0）
│ │ ├── step4-check.py # 交付自检
│ │ └── step5-check.py # 推荐板块（软+硬两层）
│ └── lib/ # 状态文件 + 文本工具
└── .github/
└── workflows/
└── build-skill-tree.yml # 自动更新
📚 平台适配指南
详细适配指南见 SKILL.md 中的【平台映射表】章节。
支持的框架
- 国际：ChatGPT, Claude, Codex, Gemini, Cursor, Windsurf, Cline, GitHub Copilot
- 国内：WorkBuddy, 扣子 (Coze), 文心一言, 通义千问, Kimi, 豆包, 智谱, 月之暗面, Dify
🤝 贡献
欢迎提交 Issue 和 PR：
- 功能增强：扩展分类规则、增加平台映射
- 文档优化：修正表述、增加示例
- Bug 修复：分类逻辑、脚本错误
📄 License
MIT License — 随意使用、修改、分发。
👤 作者
jiabaobei — GitHub
如果这个规则帮你解决了 Agent 不调用能力的问题，欢迎 ⭐ Star 收藏，转发给身边被 Agent 气到的朋友！