✨ feat(skills): add built-in workflow skills

SKILLS.md

@@ -21,6 +21,8 @@
 
 > 兼容提示：少数旧示例使用 `.claude/skill/`（无 `s`）。以你当前 Claude Code 版本的实际加载行为为准；若 `.claude/skills/` 不生效再尝试旧路径。
 
+> 分发建议：`SKILLS.md` 建议只保留**一份**在仓库根目录；语言/领域差异通过“不同 skill”或 `references/` 分层解决，不要把同一份指南复制到每个语言目录里。
+
 ### 1.2 SKILL.md 最小规范（必须满足）
 
 - YAML frontmatter 必填：`name`、`description`
@@ -110,7 +112,9 @@ Skill 应只包含：
 
 ## 4. 示例：`code-review-workflow`（面向专家的评审技能）
 
-将下面内容保存到：`.claude/skills/code-review-workflow/SKILL.md`
+本仓库已内置该示例 skill：`.claude/skills/code-review-workflow/SKILL.md`
+
+如果你要在**目标项目**里使用，请把该目录复制到目标项目根目录的 `.claude/skills/` 下。
 
 ```markdown
 ---
@@ -226,6 +230,52 @@ cp -r Claude-meta-skill/prompt-optimize .claude/skills/
 cp -r Claude-meta-skill/deep-reading-analyst .claude/skills/
 ```
 
+### 6.3 obra/superpowers（调试与证据链）
+
+来源：https://github.com/obra/superpowers（MIT）
+
+如果你只想要“专家级调试与验证”，优先关注这几项（不包含 PR/计划链路也能独立使用）：
+
+- `systematic-debugging`：四阶段调试框架（先定位再修）
+- `root-cause-tracing`：回溯触发源（修根因不修症状）
+- `defense-in-depth`：分层校验（让 bug 结构性不可发生）
+- `verification-before-completion`：证据优先（跑命令/看输出再宣称完成）
+
+安装（Claude Code 插件方式，会带上完整 superpowers 套件）：
+
+- `/plugin marketplace add obra/superpowers-marketplace`
+- `/plugin install superpowers@superpowers-marketplace`
+
+### 6.4 mhattingpete/claude-skills-marketplace（批量操作/可视化文档/执行时省 token）
+
+来源：https://github.com/mhattingpete/claude-skills-marketplace（Apache-2.0）
+
+不走 PR 流水线时，仍然很有价值的方向：
+
+- **Code Operations**：`code-refactor`（批量重构）、`file-operations`（结构化文件分析）、`code-transfer`（精确插入/迁移）
+- **Productivity**：`codebase-documenter`（生成仓库文档）、`code-auditor`（质量审计）
+- **Visual Docs**：架构图/流程图/时间线/仪表盘（把系统/变更讲清楚）
+- **Execution Runtime**：把“批量处理”变成脚本执行，显著降低上下文与 token 开销
+
+安装（按需选装插件）：
+
+- `/plugin marketplace add mhattingpete/claude-skills-marketplace`
+- 或安装单一插件 marketplace（见其 README 的分插件路径）
+
+### 6.5 awesome-claude-skills（发现入口）
+
+来源：https://github.com/BehiSecc/awesome-claude-skills
+
+建议用途：当你想补齐某个“领域能力”时（文档、数据、媒体、安全、自动化），先从该列表按关键词搜，再回到第 2 节的原则把它们改造成“你们仓库可执行的 SOP”。
+
+> 注意：外部 skills 的许可协议差异很大（有些是 Proprietary / 未标注许可），**不要直接复制进你们仓库分发**，先确认 License 与合规策略。
+
+### 6.6 本 Playbook 内置的文档工作流 skill（建议先用这个）
+
+本仓库已内置：`.claude/skills/document-workflow/SKILL.md`
+
+它的定位是“统一入口 + 依赖探测”：优先使用 Anthropic `document-skills`，否则走开源 fallback（需你确认是否安装依赖/工具）。
+
 ---
 
 ## 7. 运行时排障（面向专家）