From 69b92973cb64b5bf04e48883d812aead3ab48edf Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Thu, 12 Feb 2026 02:34:30 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E9=87=8D=E5=91=BD=E5=90=8D=20claud?= =?UTF-8?q?e-skills=20=E2=86=92=20skills-skills?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- README.md | 4 ++-- skills/README.md | 8 +++---- skills/canvas-dev/README.md | 2 +- skills/ddd-doc-steward/SKILL.md | 2 +- .../AGENTS.md | 24 +++++++++---------- .../{claude-skills => skills-skills}/SKILL.md | 18 +++++++------- .../assets/template-complete.md | 2 +- .../assets/template-minimal.md | 0 .../references/README.md | 0 .../references/anti-patterns.md | 0 .../references/index.md | 2 +- .../references/quality-checklist.md | 0 .../references/skill-spec.md | 2 +- .../scripts/create-skill.sh | 0 .../scripts/validate-skill.sh | 0 skills/tmux-autopilot/SKILL.md | 4 ++-- 17 files changed, 35 insertions(+), 35 deletions(-) rename skills/{claude-skills => skills-skills}/AGENTS.md (63%) rename skills/{claude-skills => skills-skills}/SKILL.md (93%) rename skills/{claude-skills => skills-skills}/assets/template-complete.md (97%) rename skills/{claude-skills => skills-skills}/assets/template-minimal.md (100%) rename skills/{claude-skills => skills-skills}/references/README.md (100%) rename skills/{claude-skills => skills-skills}/references/anti-patterns.md (100%) rename skills/{claude-skills => skills-skills}/references/index.md (97%) rename skills/{claude-skills => skills-skills}/references/quality-checklist.md (100%) rename skills/{claude-skills => skills-skills}/references/skill-spec.md (98%) rename skills/{claude-skills => skills-skills}/scripts/create-skill.sh (100%) rename skills/{claude-skills => skills-skills}/scripts/validate-skill.sh (100%) diff --git a/AGENTS.md b/AGENTS.md index 5e0fe3d..5595d6a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -157,7 +157,7 @@ git push │ └── README.md # 在线表格链接 │ ├── skills/ # 技能库（扁平化，详见 skills/README.md） -│ ├── claude-skills/ # 元技能核心 +│ ├── skills-skills/ # 元技能核心 │ ├── sop-generator/ # SOP 生成 │ ├── canvas-dev/ # Canvas白板驱动开发 │ ├── headless-cli/ # 无头模式 AI CLI diff --git a/README.md b/README.md index 668008f..3913c7d 100644 --- a/README.md +++ b/README.md @@ -329,7 +329,7 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真 * [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。 * [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。 * [**通用项目架构模板**](./documents/00-基础指南/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 -* [**元技能：Skills 的 Skills**](./skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。 +* [**元技能：Skills 的 Skills**](./skills/skills-skills/SKILL.md): 用于生成 Skills 的元技能。 * [**SOP 生成 Skill**](./skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。 * [**tmux快捷键大全**](./documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。 * [**LazyVim快捷键大全**](./documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 @@ -416,7 +416,7 @@ Canvas方式：**代码 ⇄ 白板 ⇄ AI ⇄ 人类**，白板成为单一真 │ └── README.md # 在线表格链接 │ ├── skills/ # 技能库（扁平化） -│ ├── claude-skills/ # 元技能核心 +│ ├── skills-skills/ # 元技能核心 │ ├── sop-generator/ # SOP 生成 │ ├── canvas-dev/ # Canvas白板驱动开发 │ ├── headless-cli/ # 无头模式 AI CLI diff --git a/skills/README.md b/skills/README.md index 7dfb40c..8f599ee 100644 --- a/skills/README.md +++ b/skills/README.md @@ -8,7 +8,7 @@ | 技能 | 说明 | |:---|:---| -| [claude-skills](./claude-skills/SKILL.md) | ⭐ 生成 Skills 的 Skills | +| [skills-skills](./skills-skills/SKILL.md) | ⭐ 生成 Skills 的 Skills | | [sop-generator](./sop-generator/SKILL.md) | SOP 生成与规范化 | ### 🤖 AI 工具 @@ -58,7 +58,7 @@ ```bash # 查看元技能 -cat skills/claude-skills/SKILL.md +cat skills/skills-skills/SKILL.md # 查看无头 CLI 技能 cat skills/headless-cli/SKILL.md @@ -71,11 +71,11 @@ cat skills/postgresql/SKILL.md 使用元技能生成： 1. 准备领域资料（文档、代码、规范） -2. 将资料和 `claude-skills/SKILL.md` 一起提供给 AI +2. 将资料和 `skills-skills/SKILL.md` 一起提供给 AI 3. AI 会生成针对该领域的专用 Skill ## 相关资源 -- [元技能文件](./claude-skills/SKILL.md) - 生成 Skills 的 Skills +- [元技能文件](./skills-skills/SKILL.md) - 生成 Skills 的 Skills - [提示词库](../prompts/) - 更细粒度的提示词集合 - [文档库](../documents/) - 方法论与开发经验 diff --git a/skills/canvas-dev/README.md b/skills/canvas-dev/README.md index 1b94362..b2a8c6c 100644 --- a/skills/canvas-dev/README.md +++ b/skills/canvas-dev/README.md @@ -36,4 +36,4 @@ canvas-dev/ - [Canvas白板驱动开发详解](../../documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md) - [Canvas开发工作流](../../workflow/canvas-dev/) -- [元技能: claude-skills](../00-元技能/claude-skills/SKILL.md) +- [元技能: skills-skills](../00-元技能/skills-skills/SKILL.md) diff --git a/skills/ddd-doc-steward/SKILL.md b/skills/ddd-doc-steward/SKILL.md index 5f94b0c..b57c5aa 100644 --- a/skills/ddd-doc-steward/SKILL.md +++ b/skills/ddd-doc-steward/SKILL.md @@ -94,7 +94,7 @@ description: "文档驱动开发（DDD）文档管家：以仓库真实证据为 ## 维护 -- 来源：`prompts/02-编程提示词/文档驱动开发/DDD 文档管家 Agent 工业级提示词.md`；元技能 `00-元技能/claude-skills/`；自动化辅助工具 `libs/external/Skill_Seekers-development`. +- 来源：`prompts/02-编程提示词/文档驱动开发/DDD 文档管家 Agent 工业级提示词.md`；元技能 `00-元技能/skills-skills/`；自动化辅助工具 `libs/external/Skill_Seekers-development`. - 最后更新：2025-12-20 - 已知限制：依赖用户提供真实证据；大体量仓库需分批；不输出敏感值。 diff --git a/skills/claude-skills/AGENTS.md b/skills/skills-skills/AGENTS.md similarity index 63% rename from skills/claude-skills/AGENTS.md rename to skills/skills-skills/AGENTS.md index 9a6714b..390dd7a 100644 --- a/skills/claude-skills/AGENTS.md +++ b/skills/skills-skills/AGENTS.md @@ -1,11 +1,11 @@ -# skills/claude-skills +# skills/skills-skills This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding. ## Layout ``` -claude-skills/ +skills-skills/ |-- AGENTS.md |-- SKILL.md |-- assets/ @@ -24,16 +24,16 @@ claude-skills/ ## File Responsibilities -- `skills/claude-skills/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling). -- `skills/claude-skills/assets/template-minimal.md`: minimal template (small domains / quick bootstrap). -- `skills/claude-skills/assets/template-complete.md`: full template (production-grade / complex domains). -- `skills/claude-skills/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite). -- `skills/claude-skills/scripts/validate-skill.sh`: spec validator (supports `--strict`). -- `skills/claude-skills/references/index.md`: navigation for this meta-skill's reference docs. -- `skills/claude-skills/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo). -- `skills/claude-skills/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER). -- `skills/claude-skills/references/quality-checklist.md`: quality gate checklist + scoring. -- `skills/claude-skills/references/anti-patterns.md`: common failure modes and how to fix them. +- `skills/skills-skills/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling). +- `skills/skills-skills/assets/template-minimal.md`: minimal template (small domains / quick bootstrap). +- `skills/skills-skills/assets/template-complete.md`: full template (production-grade / complex domains). +- `skills/skills-skills/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite). +- `skills/skills-skills/scripts/validate-skill.sh`: spec validator (supports `--strict`). +- `skills/skills-skills/references/index.md`: navigation for this meta-skill's reference docs. +- `skills/skills-skills/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo). +- `skills/skills-skills/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER). +- `skills/skills-skills/references/quality-checklist.md`: quality gate checklist + scoring. +- `skills/skills-skills/references/anti-patterns.md`: common failure modes and how to fix them. ## Dependencies & Boundaries diff --git a/skills/claude-skills/SKILL.md b/skills/skills-skills/SKILL.md similarity index 93% rename from skills/claude-skills/SKILL.md rename to skills/skills-skills/SKILL.md index 431e338..9123d7f 100644 --- a/skills/claude-skills/SKILL.md +++ b/skills/skills-skills/SKILL.md @@ -1,5 +1,5 @@ --- -name: claude-skills +name: skills-skills description: "Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates." --- @@ -158,15 +158,15 @@ Validate locally: ```bash # From repo root (basic validation) -./skills/claude-skills/scripts/validate-skill.sh skills/ +./skills/skills-skills/scripts/validate-skill.sh skills/ # From repo root (strict validation) -./skills/claude-skills/scripts/validate-skill.sh skills/ --strict +./skills/skills-skills/scripts/validate-skill.sh skills/ --strict -# From skills/claude-skills/ (basic validation) +# From skills/skills-skills/ (basic validation) ./scripts/validate-skill.sh ../ -# From skills/claude-skills/ (strict validation) +# From skills/skills-skills/ (strict validation) ./scripts/validate-skill.sh ../ --strict ``` @@ -176,13 +176,13 @@ Generate a new Skill skeleton: ```bash # From repo root (generate into ./skills/) -./skills/claude-skills/scripts/create-skill.sh my-skill --full --output skills +./skills/skills-skills/scripts/create-skill.sh my-skill --full --output skills -# From skills/claude-skills/ (generate into ../ i.e. ./skills/) +# From skills/skills-skills/ (generate into ../ i.e. ./skills/) ./scripts/create-skill.sh my-skill --full --output .. # Minimal skeleton -./skills/claude-skills/scripts/create-skill.sh my-skill --minimal --output skills +./skills/skills-skills/scripts/create-skill.sh my-skill --minimal --output skills ``` Templates: @@ -238,6 +238,6 @@ External (official): ## Maintenance -- Sources: local spec files in `skills/claude-skills/references/` + upstream official docs in `references/README.md` +- Sources: local spec files in `skills/skills-skills/references/` + upstream official docs in `references/README.md` - Last updated: 2025-12-14 - Known limits: `validate-skill.sh` is heuristic; strict mode assumes the recommended section headings diff --git a/skills/claude-skills/assets/template-complete.md b/skills/skills-skills/assets/template-complete.md similarity index 97% rename from skills/claude-skills/assets/template-complete.md rename to skills/skills-skills/assets/template-complete.md index d6182a4..265e4d3 100644 --- a/skills/claude-skills/assets/template-complete.md +++ b/skills/skills-skills/assets/template-complete.md @@ -75,7 +75,7 @@ Trigger when any of these applies: ## Quality Gate -Minimum checks before shipping (see meta-skill `claude-skills` for the full version): +Minimum checks before shipping (see meta-skill `skills-skills` for the full version): 1. `description` is decidable ("what + when") and includes trigger keywords 2. Has "When to Use This Skill" with decidable triggers diff --git a/skills/claude-skills/assets/template-minimal.md b/skills/skills-skills/assets/template-minimal.md similarity index 100% rename from skills/claude-skills/assets/template-minimal.md rename to skills/skills-skills/assets/template-minimal.md diff --git a/skills/claude-skills/references/README.md b/skills/skills-skills/references/README.md similarity index 100% rename from skills/claude-skills/references/README.md rename to skills/skills-skills/references/README.md diff --git a/skills/claude-skills/references/anti-patterns.md b/skills/skills-skills/references/anti-patterns.md similarity index 100% rename from skills/claude-skills/references/anti-patterns.md rename to skills/skills-skills/references/anti-patterns.md diff --git a/skills/claude-skills/references/index.md b/skills/skills-skills/references/index.md similarity index 97% rename from skills/claude-skills/references/index.md rename to skills/skills-skills/references/index.md index 39c2537..61a2421 100644 --- a/skills/claude-skills/references/index.md +++ b/skills/skills-skills/references/index.md @@ -1,6 +1,6 @@ # Claude Skills Meta-Skill Reference Index -This directory contains long-form documentation that supports the `claude-skills` meta-skill. +This directory contains long-form documentation that supports the `skills-skills` meta-skill. ## Start Here diff --git a/skills/claude-skills/references/quality-checklist.md b/skills/skills-skills/references/quality-checklist.md similarity index 100% rename from skills/claude-skills/references/quality-checklist.md rename to skills/skills-skills/references/quality-checklist.md diff --git a/skills/claude-skills/references/skill-spec.md b/skills/skills-skills/references/skill-spec.md similarity index 98% rename from skills/claude-skills/references/skill-spec.md rename to skills/skills-skills/references/skill-spec.md index b900007..1536f04 100644 --- a/skills/claude-skills/references/skill-spec.md +++ b/skills/skills-skills/references/skill-spec.md @@ -107,5 +107,5 @@ Each Skill SHOULD include a `## Maintenance` section with: Before shipping, run the checklist in `quality-checklist.md` and (if available) the validator: ```bash -./skills/claude-skills/scripts/validate-skill.sh skills/ --strict +./skills/skills-skills/scripts/validate-skill.sh skills/ --strict ``` diff --git a/skills/claude-skills/scripts/create-skill.sh b/skills/skills-skills/scripts/create-skill.sh similarity index 100% rename from skills/claude-skills/scripts/create-skill.sh rename to skills/skills-skills/scripts/create-skill.sh diff --git a/skills/claude-skills/scripts/validate-skill.sh b/skills/skills-skills/scripts/validate-skill.sh similarity index 100% rename from skills/claude-skills/scripts/validate-skill.sh rename to skills/skills-skills/scripts/validate-skill.sh diff --git a/skills/tmux-autopilot/SKILL.md b/skills/tmux-autopilot/SKILL.md index 9232e38..286a37c 100644 --- a/skills/tmux-autopilot/SKILL.md +++ b/skills/tmux-autopilot/SKILL.md @@ -162,11 +162,11 @@ tmux pipe-pane -t :. -o 'cat >> /tmp/tmux--