一组适配 Claude Code 的通用化 skill + 团队规范。读者可整个复制到自己项目的 .claude/ 下使用，也可作为「怎么写 Claude Code skill / 怎么资产化团队规范」的参考。
对应教程：阶段 3 基础设施·Skill 仓库 / 阶段 4 闭环试点 / 阶段 6 沉淀复用。
Claude Code 的 skill 是「可复用的工作流 + 领域知识」，AI 按需调用；rule 是「始终生效的规范」，AI 自动遵守。本目录是一组 skill + rule 的集合（团队 Skill 仓库 demo），用统一的 .claude/ 布局组织。
| Skill | 类型 | 用途 |
|---|---|---|
| devflow | 编排型 | 开发工作流：需求→交付 6 阶段（编排 OpenSpec + Superpowers），断点续传 + 规则覆盖 ⚠️ 需预装 OpenSpec CLI + Superpowers |
| sql-query | 工具型 | PostgreSQL 只读查询（三模式 + 安全护栏：仅 SELECT/SSH 隧道/租户隔离）+ 模板/schema 双策略 |
| crud-gen | 工具型 | CRUD 代码脚手架生成（读表结构 → 分层 domain/dto/service/dao/controller + 字段→操作符映射） |
| code-review | 编排型 | AI 代码审查（红/黄/绿三级分级 + 依据下方 rule 规范自动核对 + 结构化报告） |
| brand-guidelines | 规范型 | 品牌合规：生成/检查 UI 文档符合色卡字体规范，含校验器违规即报 |
| perf-diagnosis | 诊断型 | 性能诊断（只读）：慢 SQL/内存/链路归因，给建议不改动系统 |
| session-memory | 记忆型 | 会话记忆：长对话结构化压缩，按优先级保留用户纠正与关键决策 |
rules/，12 份通用 rule，复制到 .claude/rules/ 即用）按职能分层，配合 team-conventions.md（通用 CLAUDE.md 总纲，用 @ 引用下面所有 rule）：
另有 devflow.md 是 devflow skill 的「覆盖规则」（改写底层 skill 默认出口），不属于团队规范。
best-practices.md — Claude Code 用得顺手的 8 条心法（验证驱动/Plan Mode/上下文管理/子代理防火墙/五件套辨析/Headless/多会话并行）+ skill 写得值钱的 5 条方法论（SKILL.md 三件套/渐进披露/编排不实现/命名空间/安全审核）+ 多 Agent 避坑 6 条 + 速查卡。
README 讲「仓库怎么用」，best-practices 讲「怎么用得顺手」。
.claude/ 布局）claude-skills/
├── skills/ # 各 skill 自包含一个目录
│ ├── devflow/ # SKILL.md + guide + stages/（编排型）
│ ├── sql-query/ # SKILL.md + queries.json + scripts/（工具型·查询）
│ ├── crud-gen/ # SKILL.md（工具型·代码生成）
│ ├── code-review/ # SKILL.md（编排型·审查）
│ ├── brand-guidelines/# SKILL.md + scripts(validate/apply)+ tests（规范型）
│ ├── perf-diagnosis/ # SKILL.md + scripts(analyze)+ reference（诊断型·只读）
│ └── session-memory/ # SKILL.md + scripts(compress)+ reference（记忆型）
├── rules/ # 规则文件（team-conventions 总纲 + 11 分层规范 + devflow 覆盖规则）
├── best-practices.md # 实战心法
└── settings.json # 配置样例（hooks / 权限）
三件套：一个 skill = SKILL.md（入口）+ 可选 reference/scripts（按需加载）+ 可选 rules/<name>.md（覆盖规则）。
把需要的 skill + rule 复制到自己项目的 .claude/ 下。
Mac / Linux（命令行）：
# 例：装 devflow + 团队规范到你的项目
cp -r skills/devflow /your-project/.claude/skills/
cp rules/devflow.md /your-project/.claude/rules/
# 装团队规范（CLAUDE.md 用 @ 引用 rule，AI 自动加载）
cp rules/team-conventions.md /your-project/.claude/rules/
cp rules/{testing,error-handling,database,...}.md /your-project/.claude/rules/
# 然后在项目根 CLAUDE.md 里 @ 引用它们
Windows（命令行二选一）：
# PowerShell：装 devflow + 规则
xcopy /E /I skills\devflow your-project\.claude\skills\devflow
copy rules\devflow.md your-project\.claude\rules\
# 或装团队规范
copy rules\team-conventions.md your-project\.claude\rules\
copy rules\testing.md your-project\.claude\rules\
# （其余 rule 同样 copy）
不想敲命令：直接用资源管理器复制文件夹——把
skills\devflow整个目录拖进your-project\.claude\skills\，把rules\*.md复制进your-project\.claude\rules\，效果一样。
.claude/ 长什么样以装了 devflow + sql-query 两个 skill + 团队规范为例，你的项目 .claude/ 目录最终结构：
your-project/
├── .claude/
│ ├── skills/
│ │ ├── devflow/
│ │ │ ├── SKILL.md
│ │ │ ├── stages/
│ │ │ └── reference/
│ │ └── sql-query/
│ │ ├── SKILL.md
│ │ ├── queries.json
│ │ └── scripts/
│ ├── rules/
│ │ ├── team-conventions.md # CLAUDE.md 用 @ 引用的总纲
│ │ ├── testing.md
│ │ ├── error-handling.md
│ │ ├── database.md
│ │ └── devflow.md # devflow 的覆盖规则
│ └── settings.json # hooks / 权限（可选）
└── CLAUDE.md # 项目根，用 @rules/.claude/rules/xxx.md 引用上面规则
在项目根目录启动 Claude Code，跟它说一句某个 skill 的用途，看它有没有自动调用。例如装了 sql-query 后，在对话里说「帮我查询数据库里最近 7 天的订单」，Claude 应该会自动识别这是查询场景、调用 sql-query skill（而不是去写一段手搓的 SQL 脚本）。如果它没自动调用，多半是 SKILL.md frontmatter 的 description 没写清「何时触发」——回去把触发场景写明白。
加载机制：
SKILL.md的 frontmatter（name + description）常驻上下文，正文按需读取；rule 被 CLAUDE.md@引用后始终生效——所以 frontmatter description 要写清「何时触发」，rule 要写清「AI 必须守的规范」。
skills/<name>/，写 SKILL.md（frontmatter + 正文）；复杂内容拆 reference/scripts 按需加载rules/<name>.md，在 team-conventions.md 用 @ 引用rules/<name>.md 写覆盖规则（如 devflow.md）写好 skill 的 4 个关键（devflow 的实践总结）：
rules/ 始终生效，用来改写底层 skill 的默认出口 / 边界新增的 3 个 skill（brand-guidelines / perf-diagnosis / session-memory）带
tests/单测 +scripts/verify.sh自检，是比早期 skill 更完整的范式（校验器 / 只读边界 / 优先级设计均有测试覆盖）。其余 skill 可按此补齐。