repo-to-skill

name	repo-to-skill
description	当用户要求"把仓库总结成skill"、"基于项目生成skill"、"从repo提取skill"、"将项目经验做成skill"时触发。自动读取.claude/repo下的指定项目，提炼源码和PROJECT_INDEX.md中的可复用模式，生成标准skill文件。

Repo to Skill — 仓库经验提炼为元 Skill

核心原则

先读仓库，再提模式，后生成 skill。

repo-to-skill 是"从项目仓库自动创建 skill 的元 skill"，不是要被修改的 skill。

每次基于仓库创建新 skill 时，必须：

1. 读取项目 — 从 .claude/repo/<项目名>/ 获取源码和索引
2. 提炼模式 — 提取可复用的流程、模式、最佳实践
3. 生成 skill — 按照 key_board 规范创建标准 skill 文件
4. 独立目录 — 新 skill 必须在 .claude/skills/<新skill名称>/ 下

触发条件

当用户说以下内容时触发：

• "把 repo X 总结成 skill"
• "基于这个项目生成 skill"
• "从仓库提取 skill"
• "将项目经验做成 skill"
• "把仓库提炼成 skill"

工作流程（必须按序执行）

Step 1: 确认目标仓库

确定用户指定的仓库名称，检查其存在于 .claude/repo/<项目名>/：

Glob: .claude/repo/*/

如果不存在，停止并告知用户可用仓库列表。

Step 2: 扫描项目索引

读取目标项目的 PROJECT_INDEX.md（如有）：

Read: .claude/repo/<项目名>/PROJECT_INDEX.md
Read: .claude/repo/<项目名>/PROJECT_INDEX.json（可选）

提取信息：

• 项目名称、核心模块
• 功能描述、架构概述
• 关键文件清单

Step 3: 深入关键源码

基于索引，选择最具代表性的源码文件深入读取：

Glob: .claude/repo/<项目名>/**/*.dart（或对应语言）
Read: 关键源码文件
Grep: 核心模式、API、配置项

提取可复用模式：

• 触发场景 — 什么情况下使用这个流程？
• 核心逻辑 — 关键步骤和决策点
• 输入输出 — 需要什么参数？产出什么结果？
• 最佳实践 — 项目中的约定和优化点
• 坑点警示 — 项目中踩过的坑和解决方案

Step 4: 提炼 Skill 结构

基于分析结果，回答三个问题：

• 这个 skill 要解决什么问题？（从仓库经验中提炼）
• 什么时候触发？（什么场景下调用）
• 输出格式是什么？（skill 的使用方式）

Step 5: 生成 SKILL.md

创建独立目录和文件：

mkdir -p .claude/skills/<skill名称>/

编写 SKILL.md，必须包含 YAML frontmatter：

---
name: <skill名称>
description: <触发描述 — 什么时候触发这个skill，不是内容总结>
---

内容结构必须包含：

1. 核心原则 — skill 的使用哲学
2. 触发条件 — 明确的触发语句列表
3. 工作流程 — 分步骤的操作指南
4. 寻找/使用指令 — 具体的工具调用示例
5. 适用场景 — ✅ 适合 / ❌ 不适合的场景
6. 错误案例 — 至少一个错误案例表格
7. 成功标准 — 检查清单

Step 6: 调用 /sc:reflect

生成后调用 /sc:reflect 验证：

• 是否遗漏了关键模式？
• 触发条件是否准确？
• 是否有潜在的误触发场景？
• skill 是否可执行、可验证？

分析指令示例

扫描仓库结构：

Glob: .claude/repo/<repo>/**/*

读取项目索引：

Read: .claude/repo/<repo>/PROJECT_INDEX.md

搜索核心模式：

Grep: class | interface | mixin | enum
Grep: TODO | FIXME | HACK
Glob: **/*.md

适用场景

✅ 从参考项目中提取可复用流程 ✅ 将项目经验沉淀为团队共享 skill ✅ 基于优秀开源项目创建领域 skill ✅ 复用项目中的调试/部署/开发流程

❌ 仓库不存在或无法读取 ❌ 项目过于简单，无提炼价值 ❌ 用户已直接给出完整的 skill 内容 ❌ 生成后未验证触发准确性

错误案例

错误操作	实际后果	正确做法
不读 PROJECT_INDEX.md 直接读源码	在海量文件中迷失，提炼偏题	先读索引建立全局视角
把项目描述直接复制为 skill 内容	生成的是项目介绍，不是可执行 skill	提炼"怎么做"而非"是什么"
description 写成项目总结	skill 无法被正确触发识别	description 必须是触发条件描述
遗漏错误案例和坑点	skill 缺少防护，用户重复踩坑	必须包含从项目中提炼的错误案例
生成的 skill 在 key_board 目录内	破坏元模板职责，skill 无法独立触发	新 skill 必须在独立目录 .claude/skills/<name>/
跳过 /sc:reflect 验证	触发条件不准确，skill 难以使用	生成后必须反思验证

我的犯错记录

错误操作	实际后果	正确做法
将项目 README 直接转化为 skill	生成的是文档而非可执行流程	提炼可操作的步骤和决策点
忽略项目中的错误处理逻辑	skill 只讲 happy path，缺少健壮性	包含错误案例和异常处理

常见坑点类型：

1. 提炼偏差 — 把项目介绍当成 skill 流程
2. 触发模糊 — description 不清晰导致无法识别
3. 目录错误 — 在错误位置创建 skill 文件
4. 验证缺失 — 生成后不验证可执行性
5. 模式遗漏 — 只读了索引没深入源码，错过关键模式

成功标准检查清单

• 确认了目标仓库存在于 .claude/repo/
• 读取了 PROJECT_INDEX.md 建立全局视角
• 深入了关键源码提取可复用模式
• 回答了三个问题（解决什么问题、何时触发、输出格式）
• 创建了独立目录 .claude/skills/<新skill>/
• SKILL.md 包含 YAML frontmatter
• name 和 description 字段完整且 description 是触发描述
• 内容包含触发场景、核心逻辑、工作流程
• 包含错误案例警示（从项目中提炼）
• 调用 /sc:reflect 进行了复盘验证
• skill 内容可操作、可验证，而非项目介绍

辅助SKILL

/using-superpowers

/skill-creator

调用 skill-creator（可选）

生成 skill 后，可选调用 skill-creator 进行：

• 测试用例编写
• 量化评估触发准确性
• 描述优化