Agent Skills Collection

一套可复用的 AI Agent 技能集合，覆盖从项目规划到开发、测试、运维的完整生命周期。适配任何从零开始的项目。

Quick Start

将 skills/ 目录复制到你的项目中：

cp -r skills/ your-project/.claude/skills/
# 或
cp -r skills/ your-project/skills/

然后在 Cursor / Claude 的 Agent Skills 配置中指向对应目录即可。

Skills 索引

核心开发闭环

Skill	说明	触发词
spec-writer	产品经理+架构师视角，从零撰写 PROJECT_SPEC.md	写 spec, write spec, 新项目, 技术方案
tech-researcher	编码前的技术调研与方案评审	调研, research, 最佳实践, 技术选型
auto-coder	读取 SPEC 自动定位任务、编码、测试、持久化	auto code, 自动开发, 继续开发
qa-tester	全自动测试执行、失败诊断、自修复	run QA, 跑测试, test and fix

辅助工具

Skill	说明	触发词
setup	交互式项目初始化向导	setup, init, 初始化, 环境配置
codebase-explainer	生成架构图、梳理代码、深度讲解	讲解代码, 生成架构图, explain codebase
resume-writer	基于项目生成定制化简历项目经历	写简历, resume, 项目经历
package	清理打包项目以便分发	package, 打包, 清理项目
skill-creator	创建新的 Agent Skill	create skill, new skill

协作关系

spec-writer ──→ tech-researcher ──→ auto-coder ──→ qa-tester
   (写什么)        (怎么做最好)        (自动写)       (自动测)
      │                                                  │
      └──────────────── 迭代闭环 ─────────────────────────┘

辅助：setup(初始化) / codebase-explainer(讲解) / resume-writer(简历) / package(打包)

典型工作流：

1. spec-writer — 从零撰写 PROJECT_SPEC.md（产品+架构视角）
2. tech-researcher — 对不确定的技术选型进行调研，更新 SPEC
3. auto-coder — 按 SPEC 排期逐任务自动开发
4. qa-tester — 全套测试 + 自动修复
5. 迭代：发现问题 → 回到 spec-writer 更新 SPEC → 继续开发

目录结构

skills/
├── README.md                          ← 本文件
├── spec-writer/                       ← 核心：从零写 SPEC
│   ├── SKILL.md
│   └── references/
│       └── chapter-templates.md       ← 7 章模板 + 示例
├── auto-coder/                        ← 核心：自动开发
│   ├── SKILL.md
│   └── references/
│       └── sync-spec-guide.md         ← SPEC 拆分同步指南
├── tech-researcher/                   ← 核心：技术调研
│   └── SKILL.md
├── qa-tester/                         ← 核心：自动测试
│   └── SKILL.md
├── setup/                             ← 辅助：初始化
│   └── SKILL.md
├── codebase-explainer/                ← 辅助：代码讲解
│   ├── SKILL.md
│   └── references/
│       └── ascii_guidelines.md        ← ASCII 架构图规范
├── resume-writer/                     ← 辅助：简历生成
│   ├── SKILL.md
│   └── references/
│       └── resume_principles.md       ← 简历编写原则
├── package/                           ← 辅助：打包清理
│   └── SKILL.md
└── skill-creator/                     ← 元技能：创建新 skill
    ├── SKILL.md
    ├── references/
    │   ├── workflows.md               ← 工作流模式
    │   └── output-patterns.md         ← 输出模式
    └── scripts/
        └── init_skill.py              ← 初始化新 skill 脚本

设计原则

1. 项目无关 — 所有技能不绑定特定项目，通过读取 PROJECT_SPEC.md 适配任何项目
2. 渐进式加载 — Metadata → SKILL.md → references，按需加载节省上下文
3. 闭环协作 — 技能之间有明确的触发和交接关系
4. 最小依赖 — 不依赖特定框架或工具链，仅依赖 Agent 的基础能力（读写文件、搜索、执行命令）

自定义

添加新技能

python skills/skill-creator/scripts/init_skill.py my-new-skill --path skills/

适配到已有项目

1. 复制 skills/ 到项目目录
2. 运行 spec-writer 生成 PROJECT_SPEC.md
3. 其他技能会自动读取 SPEC 适配项目