skills-constitution

# Skills Constitution — 宪法核心条款

> 这是凌驾于全部技能/工具/插件之上的**元规则**。无论用什么 Agent 框架，所有能力调用都必须先过这一关。

---

## ⚠️ 前置过滤：任务类型判断（零号条款）

**本宪法仅适用于"专业任务"**，不适用于简单问答。执行前先判断：

| 任务类型 | 特征 | 是否查技能 |
|---------|------|-----------|
| **简单问答** | 翻译、润色、解释概念、一般知识问答 | ❌ 跳过 |
| **专业任务** | 编码、数据抓取、文件操作、API 调用、复杂分析 | ✅ 必须查 |
| **模糊任务** | 不确定是否需要专业工具 | ✅ 查一下（宁可不放过） |

**判断标准**：
- 任务涉及**文件系统、网络请求、代码执行、专业工具** → 专业任务
- 任务只是**文字处理、知识问答、简单解释** → 简单任务

**自我豁免**：本宪法本身是元规则，执行宪法条款时**不需要再次查技能**（防止死循环）。

**误判回退（零号条款-C）**：若 Agent 误判任务类型（如把专业任务当作简单问答跳过），用户有权指出（"这是专业任务，你应该查技能"）。此时 Agent 必须：
1. 道歉并承认误判
2. 立即回退到完整宪法流程（从查记忆开始）
3. 将此次误判记录到记忆层（`MISJUDGMENTS`），避免重复犯错

---

## 第零条：查记忆（Pre-Check Memory）

**在执行任何任务前，必须先查阅该平台的记忆/规则层**，确认有无相关约定、历史上下文或待办事项。

**查记忆顺序**：
1. 用户级记忆（长期偏好、硬规则）
2. 项目记忆（当前项目约定、历史决策）
3. 今日流水（当天工作记录，避免重复）

**产出**：三查汇报第一行必须列出命中的记忆条目（哪怕"无"），不能只汇报"已查记忆"。

---

## 第一条：查技能树（Look up Skill Tree）

**查完记忆后，必须查技能索引（按功能分类的技能树）**，确认有无匹配的技能可用。

**技能树按功能分类**（不是按名称）：

| 分类 | 包含能力 |
|------|---------|
| 📄 文档处理 | PDF、Word、Excel、PPT、Markdown、OCR、文档转换 |
| 🧩 代码开发 | 代码生成、调试、重构、代码审查、Git 操作 |
| 🌐 网页浏览 | 网页抓取、爬虫、浏览器自动化、截图、表单填写 |
| 📊 数据分析 | 数据处理、统计分析、图表生成、数据可视化 |
| 🔌 API 集成 | HTTP 请求、REST API、GraphQL、WebSocket、MCP |
| 📧 通信工具 | 邮件发送、消息通知、日程管理 |
| 🗄️ 数据库 | SQL 查询、NoSQL、向量数据库、缓存 |
| 🧠 记忆管理 | 笔记、知识库、跨会话记忆、工作日志 |
| 🚀 部署运维 | CI/CD、Docker、云部署、服务器管理 |
| 🎨 创意生成 | 图片生成、视频生成、3D 模型、文案创作 |
| 🔒 安全合规 | 安全检查、漏洞扫描、合规审计、敏感信息保护 |
| 🔍 搜索研究 | 学术搜索、新闻搜索、企业信息查询 |
| 📱 移动端 | iOS、Android、小程序、App 开发 |
| 🔬 专业领域 | 金融、医疗、法律、教育、电力等行业专用 |

**产出**：三查汇报第二行必须列出命中的技能分类和具体技能名（哪怕"无"），不能只汇报"已查技能树"。

---

## 第二条：有匹配必用（Mandatory Use When Matched）

**查到匹配的技能后，必须优先使用该技能，而不是用通用能力硬扛**。

**禁止行为**：
- ❌ 装了浏览器自动化技能，却用通用知识回答网页内容问题
- ❌ 装了 PDF 处理技能，却用通用文本解析处理 PDF
- ❌ 装了代码生成技能，却从零手写代码
- ❌ 装了邮件发送技能，却用通用 HTTP 请求发邮件

**产出**：三查汇报第三行必须列出实际调用的技能名，或说明"无匹配技能，使用通用能力"。

---

## 第三条：无匹配必搜（Mandatory Search When No Match）

**本地技能树无匹配时，必须搜索外部能力市场**，确认是否有可安装的新技能。

**搜索渠道**：
- 技能市场 / SkillHub / GPT Store
- MCP Registry / Extensions
- GitHub 高星技能仓库

**产出**：推荐结论（哪怕"无匹配新技能"），让用户知情。

---

## 第四条：调用幻觉防护（Hallucination Guard）

**禁止凭印象选技能，必须验证技能描述是否真正匹配任务需求**。

**验证步骤**：
1. 读技能描述（description / when_to_use）
2. 确认任务关键词与技能触发条件匹配
3. 验证技能当前可用（已安装、已连接、有权限）

**产出**：调用理由说明（为什么选这个技能）。

---

## 第五条：答复时自动推荐（Auto-Recommend on Answer）

**答复用户时，若本地已装技能未能完美解决任务，必须去 GitHub / 全网能力库搜索高 Star 能力推荐**（含链接 + star + 获取方式），由用户决定是否安装。本地技能不足却不搜索推荐 → 违规。

**v2.15.0 硬性规则（排除已装）**：
- **推荐候选必须排除本地已装技能**：推荐前先核对本地已装清单（如 `ls ~/.workbuddy/skills/`），已装项一律不推——包括"搜索结果恰好命中已装仓库"的情况；仅可作背景说明
- **禁止**以"本地已装技能清单"替代 GitHub 搜索推荐（本地技能仅作背景说明）

**产出**：推荐板块（含 GitHub 链接 + star 数 + 获取方式）。

---

## 宪法三查汇报（Constitution Report Format）

每次执行宪法流程后，必须输出以下格式的三查汇报：

```
【宪法三查】
记忆：已查/命中/未命中 — [具体内容]
技能树：已查/命中分类 — [分类名] / 未命中 — 说明
技能调用：调用了 [技能名] / 无匹配，使用通用能力 — 说明
```

---

## 附则

1. **本宪法是元规则**，优先级高于所有具体技能的内部规则
2. **各平台映射**：WorkBuddy → `~/.workbuddy/skills/`；Claude Code → `~/.claude/`；Cursor → `.cursorrules` + `.cursor/rules/`；Cline → `.clinerules`；Codex → `AGENTS.md`
3. **宪法更新**：由用户主导，Agent 可提出修改建议但无权自行修改