# AI智能体技能集合

`AI智能体` `技能插件` `Claude Code` `工作流` `开发工具`

# 智能体技能集

个人收集的 AI 编程智能体技能库。每个技能封装了指令、参考资料和工作流，将智能体的能力扩展到默认范围之外。

## 什么是技能？

技能是封装好的指令包，用于教会 AI 智能体新的工作流和专业知识。可以将其理解为插件 —— 一个带有 YAML 前置元数据的 `SKILL.md` 文件告诉智能体何时激活，Markdown 内容告诉它该做什么。支撑文件（参考资料、模板、脚本）按需加载，以将上下文占用控制在最小范围。

```
skill-name/
  SKILL.md              # 入口：前置元数据 + 指令
  references/           # 按需加载的详细文档
  CHANGELOG.md
  README.md
```

技能遵循 [Agent Skills](https://agentskills.io) 开放标准，该标准起源于 Claude Code，现已被所有主流 AI 编程智能体采用。

## 技能列表

| 技能 | 类别 | 描述 |
|------|------|------|
| **[design-builder](skills/(design)/design-builder)** | 设计 | 产品工程师设计流水线：提取文案和设计令牌、定义结构、预览并审批设计 |
| **[debug-tools](skills/(development)/debug-tools)** | 开发 | 迭代调试：调查、修复、验证循环，支持模式比较和升级上报，含置信度评分 |
| **[project-index](skills/(development)/project-index)** | 开发 | 生成项目上下文和深度代码库文档（含代码片段），在 `.agents/` 中创建深度优先的文档 |
| **[spec-driven](skills/(development)/spec-driven)** | 开发 | 规格驱动开发：规格说明、设计、任务拆分、实现，按复杂度自动调整规模，全流程可追溯 |
| **[brainstorming](skills/(product)/brainstorming)** | 产品 | 结构化创意探索：发现上下文、发散思维、聚焦方向，可衔接 docs-writer、spec-driven、design-builder |
| **[docs-writer](skills/(product)/docs-writer)** | 产品 | 结构化文档生成：PRD、简报、设计文档、TDD、RFC、ADR，按文档类型引导式发现 |
| **[epic-tracker](skills/(product)/epic-tracker)** | 产品 | 交付生命周期管理：规划史诗、跟踪故事和缺陷、按版本分组，可衔接 spec-driven |
| **[product-naming](skills/(product)/product-naming)** | 产品 | 调研并验证产品名称，含域名/社交媒体可用性检查及质量评分 |
| **[git-helpers](skills/(tooling)/git-helpers)** | 工具 | 规范提交、置信度评分的代码审查、PR 摘要、拉取请求创建及分支生命周期管理 |
| **[session-notes](skills/(tooling)/session-notes)** | 工具 | 在 Obsidian 中创建笔记，支持项目、公司、挑战、亮点、日志、会话、决策和对话等类型 |

## 技能协作关系

```mermaid
flowchart TD
    BR[brainstorming] -->|方向| DW[docs-writer]
    BR -->|方向| PN[product-naming]
    BR -->|方向| DB[design-builder]
    PN -->|名称| DW
    PN -->|名称| DB
    DW -->|需求| ET[epic-tracker]
    DW -->|需求| DB[design-builder]
    ET -->|交接| SD[spec-driven]
    PI[project-index] -->|代码库文档| SD
    PI -->|规范约定| DB
    DB -->|审批设计| SD
    SD -->|提交/审查| GH[git-helpers]
    SD -->|新发现| PI
    GH -->|会话收尾| SN[session-notes]
    DT[debug-tools] -.->|升级上报| SD
```

## 完整项目流程

```
1. brainstorming     --> 探索创意，确定方向
2. product-naming    --> 调研并验证名称
3. docs-writer       --> 生成需求文档（PRD、简报）
4. epic-tracker      --> 规划史诗，跟踪故事和缺陷
5. project-index     --> 扫描代码库（已有项目时）
6. design-builder    --> 提取、结构化、预览、审批
7. spec-driven       --> 规格说明、设计、任务、实现
8. git-helpers       --> 提交、审查、PR、收尾
9. session-notes     --> 记录已完成的工作
10. debug-tools      --> 出现问题时使用
```

## 输出目录结构

技能将产物写入 `.artifacts/`，将参考上下文写入 `.agents/`：

```
.agents/
├── project.md      # project-index：项目上下文
├── codebase/       # project-index：深度代码库分析
└── baselines/      # spec-driven：功能区域行为基线

.artifacts/
├── features/       # spec-driven：功能规格、设计、任务
├── quick/          # spec-driven：快速模式任务
├── research/       # spec-driven：调研缓存
├── epics/          # epic-tracker：史诗、故事、缺陷、版本
├── brainstorm/     # brainstorming：创意产物
├── docs/           # docs-writer + product-naming
└── design/         # design-builder：copy.yaml、design.json、变体
```

该目录默认被 gitignore，但可以提交至版本库以支持团队协作。

## 安装

使用 [Skills CLI](https://skills.sh) 通过单条命令安装任意技能：

```bash
npx skills add adeonir/agent-skills
```

## 许可证

MIT