name	key_board_2
description	当用户要求"总结成skill"、"保存对话为skill"、"提取提示词"、"做成技能"时触发。这是元技能模板，用于指导创建其他技能，而非被创建的技能本身。

Key Board — Skill 创建元模板

依赖 skill 声明与校验（最高优先级，先于一切）

区分两层依赖，别混淆：

元层依赖：key_board_2 自己运行所需的前置 = skill-creator / writing-skills。

产物层依赖：用户在待总结内容里指名的 /xxxskill，是被创建的新 skill 的前置，必须写进新 skill 自己的 SKILL.md（frontmatter + 顶部声明），而不是写给 key_board_2。

默认前置 skill（元层）：skill-creator / writing-skills

规则

识别依赖：只要用户在指令里指名调用某个 /xxxskill（例如 /sc:reflect、/k6、/tool-isolation），即视为前置 skill——判断它属于元层还是产物层：
- 用来指导"如何创建"→ 元层依赖（key_board_2 先加载）。
- 出现在"新 skill 要做的事"里 → 产物层依赖（写进新 skill）。
显式声明：动手前，先在回复顶部用一行显式列出全部依赖：
```
依赖skill: skill-creator, writing-skills, <用户指名的其它 skill>
```
多个依赖用逗号分隔。
加载校验：逐个确认每个依赖 skill 是否存在/可加载。
加载失败 = 直接终止：只要有任意一个依赖 skill 无法加载， 立即停止，不再执行后续任何步骤，并明确提示用户：
```
⛔ 依赖 skill 无法加载：<skill名>
已终止本次 skill 创建。请先安装/修复该依赖后重试。
```

只有全部依赖都成功声明并加载后，才进入下面的「触发条件 / 创建流程」。

Worked Example：产物层依赖如何落到新 skill

用户说：

"让 ai 使用 /k6 这个 skill 进行压测，按照 /tool-isolation 的方式创建目录，并且生成报告，报告中需包含具体时间和项目状态的 commit hash，方便快速定位。"

正确处理：

识别产物层依赖：k6、tool-isolation（都是新 skill 运行时的前置）。
先校验这两个 skill 可加载；任一失败 → 立即终止并提示（见规则 4）。

新 skill 的 SKILL.md 里显式写出：

---
name: k6-load-test-report
description: <触发描述>
---
# ...
依赖skill: k6, tool-isolation
> 如任一前置无法加载，立即终止并提示用户。

报告产物要求（具体时间、项目 commit hash）作为新 skill 的输出规范写入其正文。

触发条件

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

"总结成 skill"
"保存对话为 skill"
"提取对话中的提示词"
"把我的要求存成技能文件"
"做成 skill"

核心原则

key_board 是"创建 skill 的 skill"，不是要被修改的 skill。

每次创建新 skill 时，必须：

创建独立目录 .claude/skills/<新skill名称>/
在目录内创建 SKILL.md
必须包含 YAML frontmatter

创建流程（必须按序执行）

Step 0: 依赖校验（见顶部「依赖 skill 声明与校验」）

先显式声明 依赖skill: ... 并逐个加载校验；任一依赖加载失败即终止并提示，不进入 Step 1。

Step 1: 调用 /sc:reflect 反思

先调用 /sc:reflect 进行复盘，整理：

成功案例和成功根因
错误案例和错误根因
坑点和预防方法

Step 2: Capture Intent

基于反思结果，理解用户意图，回答：

这个 skill 要解决什么问题？
什么时候触发？
输出格式是什么？

Step 3: 创建目录

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

Step 4: 编写 SKILL.md

必须包含：

---
name: <skill名称>
description: <触发描述>
---

# Skill 标题
## 内容...

Step 5: 写入内容

基于 /sc:reflect 反思结果，填充成功/失败案例和坑点警示。

易错和坑（高频错误）

错误	根因	预防
缺少 YAML frontmatter	跳过格式直接写内容	写之前先确认文件结构
在 key_board 目录内创建新 skill	混淆元模板职责	新 skill 必须在独立目录
frontmatter 的 description 放错误内容	没理解 description 是触发描述	description=触发条件，非总结
跳过 Capture Intent	急于输出	必须先回答三个问题再动手
直接修改 key_board 自身内容	把元模板当普通 skill	key_board 是模板，不应被修改
依赖 skill 没声明就动手	忽视前置 skill	先显式写出 `依赖skill: ...`
依赖加载失败仍继续创建	没做加载校验	任一依赖失败立即终止并提示

错误案例记录规范

每个 skill 必须包含错误案例：

## 错误案例

| 错误操作 | 实际后果 | 正确做法 |
|---------|---------|---------|
| ... | ... | ... |

我的犯错记录

错误操作	实际后果	正确做法
把 skill 创建在 `memory/skills/` 目录	skill 无法被系统识别和触发，分散了记忆与技能的职责	skill 必须放在 `.claude/skills/<skill名>/SKILL.md`

常见坑点类型：

格式错误 — frontmatter 缺失/错误
目录错误 — 在错误位置创建文件
理解偏差 — 误解用户意图或工具能力
流程跳跃 — 跳过必要步骤

成功标准检查清单

顶部已显式声明 依赖skill: ...（含用户指名的 /xxxskill）
已逐个校验依赖可加载；任一失败则终止并提示
创建了独立目录 .claude/skills/<新skill>/
SKILL.md 包含 YAML frontmatter
name 和 description 字段完整
description 是触发描述，不是内容总结
内容包含触发场景、核心逻辑
包含错误案例警示（高频坑点）
调用 /sc:reflect 进行复盘

调用 skill-creator

创建完 skill 后，可选调用 skill-creator 进行：

测试用例编写
量化评估
描述优化

Más de este repositorio

mismo repositorio

intent-capture

ZHLX2005/sl

当用户希望整理需求、明确目的、描述问题，或要求"生成文档"、"整理意图"、"明确现象"时触发。用于通过多轮对话收集和整理需求，不执行任何代码修改。

2026-07-253

boot-work-flow

ZHLX2005/sl

当用户说 "boot work-flow"、"初始化 work-flow"、"为这个仓库创建 work-flow skill"、"创建 <仓库名>-work-flow" 时触发。这是一个元skill：自动检测 git 仓库名 → 在项目本地创建 <repo>-work-flow skill → 仅写入项目启动方法和启动信息作为最小骨架 → 标注后续通过 /key_board_3 添加 references 增强。

2026-07-213

git-repo-cleanup

ZHLX2005/sl

清理git嵌套仓库，保持仓库隔离性，让 git add . 干净无污染。适用于 .claude/repo/ 或其他包含克隆仓库的目录。当用户提到"清理git"、"处理嵌套仓库"、"git隔离"、"保持干净"、 "部分跟踪"、"白名单子目录"、"忽略但保留子目录"、"gitignore 否定规则"、 "忽略 .tool/"、"工具目录不入库"时触发。

2026-07-213

key-board-3

ZHLX2005/sl

当用户要求"拆分到references"、"给skill加ref引导"、"把xx沉淀为reference"、"优化skill结构"、"重构skill"、"skill膨胀了"、"合并skill"、或要求"探索/扫描现有skill看哪些可合并"时触发。本 skill 专用于按主题把已有 skill 组织成渐进式指导文档——主 SKILL.md 承担主干主题、references/ 承担特化专项的特化指导，整个 skill 包高内聚、单文档承担一个主题；长度只是边缘参考。不创建新 skill、不改变前置 skill (key_board / key_board_2) 的职责。探索模式详见 [[场景E-合并审计]]。

2026-07-163

codebase-optimizer

ZHLX2005/sl

阅读任意代码库目录（不限语言/框架），分析模块与代码结构，生成防腐蚀规范 SKILL.md、更新已有 skill 使其与代码库一致、或在使用 skill 后反思同步项目经验。覆盖"创建"、"同步"、"反思"三个场景。不生成孤儿文档。

2026-07-123

gh-upstream-release

ZHLX2005/sl

Fork 模式下，把当前分支推送到 `upstream` 远端并对 `master` 提 PR（可选 squash merge）的端到端 SOP。触发场景：用户说"用 gh 推送到 upstream"、"推到 upstream 然后 PR 到 master"、"用 gh 发版"、"同步到 upstream master"、"PR 到 master"、 "发布当前分支"、"open PR against upstream"、明确给出 push + gh pr create 序列时。适用前提：本地有 `origin`（自己的 fork）和 `upstream`（canonical 仓库）两个 remote。

2026-07-043

name	key_board_2
description	当用户要求"总结成skill"、"保存对话为skill"、"提取提示词"、"做成技能"时触发。这是元技能模板，用于指导创建其他技能，而非被创建的技能本身。

Key Board — Skill 创建元模板

依赖 skill 声明与校验（最高优先级，先于一切）

区分两层依赖，别混淆：

元层依赖：key_board_2 自己运行所需的前置 = skill-creator / writing-skills。

产物层依赖：用户在待总结内容里指名的 /xxxskill，是被创建的新 skill 的前置，必须写进新 skill 自己的 SKILL.md（frontmatter + 顶部声明），而不是写给 key_board_2。

默认前置 skill（元层）：skill-creator / writing-skills

规则

识别依赖：只要用户在指令里指名调用某个 /xxxskill（例如 /sc:reflect、/k6、/tool-isolation），即视为前置 skill——判断它属于元层还是产物层：
- 用来指导"如何创建"→ 元层依赖（key_board_2 先加载）。
- 出现在"新 skill 要做的事"里 → 产物层依赖（写进新 skill）。
显式声明：动手前，先在回复顶部用一行显式列出全部依赖：
```
依赖skill: skill-creator, writing-skills, <用户指名的其它 skill>
```
多个依赖用逗号分隔。
加载校验：逐个确认每个依赖 skill 是否存在/可加载。
加载失败 = 直接终止：只要有任意一个依赖 skill 无法加载， 立即停止，不再执行后续任何步骤，并明确提示用户：
```
⛔ 依赖 skill 无法加载：<skill名>
已终止本次 skill 创建。请先安装/修复该依赖后重试。
```

只有全部依赖都成功声明并加载后，才进入下面的「触发条件 / 创建流程」。

Worked Example：产物层依赖如何落到新 skill

用户说：

"让 ai 使用 /k6 这个 skill 进行压测，按照 /tool-isolation 的方式创建目录，并且生成报告，报告中需包含具体时间和项目状态的 commit hash，方便快速定位。"

正确处理：

识别产物层依赖：k6、tool-isolation（都是新 skill 运行时的前置）。
先校验这两个 skill 可加载；任一失败 → 立即终止并提示（见规则 4）。

新 skill 的 SKILL.md 里显式写出：

---
name: k6-load-test-report
description: <触发描述>
---
# ...
依赖skill: k6, tool-isolation
> 如任一前置无法加载，立即终止并提示用户。

报告产物要求（具体时间、项目 commit hash）作为新 skill 的输出规范写入其正文。

触发条件

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

"总结成 skill"
"保存对话为 skill"
"提取对话中的提示词"
"把我的要求存成技能文件"
"做成 skill"

核心原则

key_board 是"创建 skill 的 skill"，不是要被修改的 skill。

每次创建新 skill 时，必须：

创建独立目录 .claude/skills/<新skill名称>/
在目录内创建 SKILL.md
必须包含 YAML frontmatter

创建流程（必须按序执行）

Step 0: 依赖校验（见顶部「依赖 skill 声明与校验」）

先显式声明 依赖skill: ... 并逐个加载校验；任一依赖加载失败即终止并提示，不进入 Step 1。

Step 1: 调用 /sc:reflect 反思

先调用 /sc:reflect 进行复盘，整理：

成功案例和成功根因
错误案例和错误根因
坑点和预防方法

Step 2: Capture Intent

基于反思结果，理解用户意图，回答：

这个 skill 要解决什么问题？
什么时候触发？
输出格式是什么？

Step 3: 创建目录

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

Step 4: 编写 SKILL.md

必须包含：

---
name: <skill名称>
description: <触发描述>
---

# Skill 标题
## 内容...

Step 5: 写入内容

基于 /sc:reflect 反思结果，填充成功/失败案例和坑点警示。

易错和坑（高频错误）

错误	根因	预防
缺少 YAML frontmatter	跳过格式直接写内容	写之前先确认文件结构
在 key_board 目录内创建新 skill	混淆元模板职责	新 skill 必须在独立目录
frontmatter 的 description 放错误内容	没理解 description 是触发描述	description=触发条件，非总结
跳过 Capture Intent	急于输出	必须先回答三个问题再动手
直接修改 key_board 自身内容	把元模板当普通 skill	key_board 是模板，不应被修改
依赖 skill 没声明就动手	忽视前置 skill	先显式写出 `依赖skill: ...`
依赖加载失败仍继续创建	没做加载校验	任一依赖失败立即终止并提示

错误案例记录规范

每个 skill 必须包含错误案例：

## 错误案例

| 错误操作 | 实际后果 | 正确做法 |
|---------|---------|---------|
| ... | ... | ... |

我的犯错记录

错误操作	实际后果	正确做法
把 skill 创建在 `memory/skills/` 目录	skill 无法被系统识别和触发，分散了记忆与技能的职责	skill 必须放在 `.claude/skills/<skill名>/SKILL.md`

常见坑点类型：

格式错误 — frontmatter 缺失/错误
目录错误 — 在错误位置创建文件
理解偏差 — 误解用户意图或工具能力
流程跳跃 — 跳过必要步骤

成功标准检查清单

顶部已显式声明 依赖skill: ...（含用户指名的 /xxxskill）
已逐个校验依赖可加载；任一失败则终止并提示
创建了独立目录 .claude/skills/<新skill>/
SKILL.md 包含 YAML frontmatter
name 和 description 字段完整
description 是触发描述，不是内容总结
内容包含触发场景、核心逻辑
包含错误案例警示（高频坑点）
调用 /sc:reflect 进行复盘

调用 skill-creator

创建完 skill 后，可选调用 skill-creator 进行：

测试用例编写
量化评估
描述优化