106 lines
4.9 KiB
Markdown
106 lines
4.9 KiB
Markdown
# 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 |