feat: add headless-cli skill and meta prompts/skills

Headless CLI Skill: - SKILL.md with YOLO and safe mode commands - References for Gemini/Claude/Codex CLI - Examples for batch translation, code review, multi-model Meta Prompts: - alpha-generator.md (prompt generator) - omega-optimizer.md (prompt optimizer) - prompt-template.md (standardized template) Meta Skills: - SKILL.md for creating/optimizing skills - skill-template.md (standardized template)
2025-12-19 13:41:45 +08:00 · 2025-12-19 13:41:45 +08:00 · 5d29bcf51b
parent d93279decd
commit 5d29bcf51b
11 changed files with 896 additions and 0 deletions
--- a/i18n/zh/prompts/meta_prompts/README.md
+++ b/i18n/zh/prompts/meta_prompts/README.md
@ -0,0 +1,30 @@
+# 元提示词 (Meta Prompts)
+
+> 生成提示词的提示词
+
+## 目录
+
+| 文件 | 说明 |
+|:---|:---|
+| [alpha-generator.md](./alpha-generator.md) | α-提示词：生成器，用于创建新提示词 |
+| [omega-optimizer.md](./omega-optimizer.md) | Ω-提示词：优化器，用于改进现有提示词 |
+| [prompt-template.md](./prompt-template.md) | 提示词规范化模板 |
+
+## 核心理念
+
+```
+α-提示词 (生成器) → 生成目标提示词
+Ω-提示词 (优化器) → 优化目标提示词
+递归循环 → 持续进化
+```
+
+## 使用流程
+
+1. 使用 `alpha-generator.md` 生成初版提示词
+2. 使用 `omega-optimizer.md` 优化提示词
+3. 将优化后的提示词反馈给系统，启动递归进化
+
+## 相关资源
+
+- [元提示词在线表格](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220)
+- [元方法论文档](../../documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
--- a/i18n/zh/prompts/meta_prompts/alpha-generator.md
+++ b/i18n/zh/prompts/meta_prompts/alpha-generator.md
@ -0,0 +1,86 @@
+# α-提示词 (Alpha Generator)
+
+## 元信息
+- 版本: v1.0
+- 作者: vibe-coding-cn
+- 更新: 2025-12-19
+- 标签: [meta, generator, prompt-engineering]
+
+## 目的
+
+生成高质量、结构化的提示词，用于各种 AI 任务场景。
+
+## 输入
+- 必需: 目标任务描述
+- 可选: 期望输出格式、约束条件、示例
+
+## 输出
+
+符合规范的提示词文档（Markdown 格式）
+
+## 提示词正文
+
+```
+你是一个专业的提示词工程师。请根据用户的需求，生成一个高质量的提示词。
+
+## 生成规则
+
+1. **结构化**: 使用清晰的章节划分
+2. **具体化**: 避免模糊描述，使用具体指令
+3. **可验证**: 包含明确的输出格式和验收标准
+4. **边界清晰**: 明确说明能做什么、不能做什么
+
+## 输出格式
+
+请按以下模板生成提示词：
+
+---
+# [提示词名称]
+
+## 元信息
+- 版本: v1.0
+- 标签: [相关标签]
+
+## 目的
+[一句话描述]
+
+## 输入
+- 必需: [必需输入]
+- 可选: [可选输入]
+
+## 输出
+[期望输出格式]
+
+## 提示词正文
+```
+[实际提示词内容]
+```
+
+## 使用示例
+[至少一个示例]
+
+## 注意事项
+[使用时的注意点]
+---
+
+## 用户需求
+
+请根据以下需求生成提示词：
+
+[用户在此描述需求]
+```
+
+## 使用示例
+
+**输入**:
+```
+我需要一个代码审查提示词，用于审查 Python 代码的安全性和性能问题。
+```
+
+**输出**: 生成符合模板的代码审查提示词
+
+## 注意事项
+
+- 生成的提示词应该是自包含的
+- 避免过于复杂的嵌套结构
+- 确保提示词可以直接复制使用
--- a/i18n/zh/prompts/meta_prompts/omega-optimizer.md
+++ b/i18n/zh/prompts/meta_prompts/omega-optimizer.md
@ -0,0 +1,104 @@
+# Ω-提示词 (Omega Optimizer)
+
+## 元信息
+- 版本: v1.0
+- 作者: vibe-coding-cn
+- 更新: 2025-12-19
+- 标签: [meta, optimizer, prompt-engineering]
+
+## 目的
+
+优化现有提示词，提升其效果、清晰度和可靠性。
+
+## 输入
+- 必需: 待优化的提示词
+- 可选: 优化目标、问题描述、失败案例
+
+## 输出
+
+优化后的提示词 + 优化说明
+
+## 提示词正文
+
+```
+你是一个专业的提示词优化专家。请分析并优化用户提供的提示词。
+
+## 优化维度
+
+1. **清晰度**: 指令是否明确无歧义
+2. **完整性**: 是否包含所有必要信息
+3. **结构性**: 组织是否合理
+4. **可靠性**: 是否能稳定产出预期结果
+5. **效率**: 是否简洁高效
+
+## 优化流程
+
+1. **诊断**: 识别现有提示词的问题
+2. **分析**: 分析问题根因
+3. **优化**: 提出改进方案
+4. **验证**: 说明优化后的预期效果
+
+## 输出格式
+
+### 诊断报告
+
+| 维度 | 评分(1-5) | 问题 |
+|:---|:---|:---|
+| 清晰度 | X | [问题描述] |
+| 完整性 | X | [问题描述] |
+| 结构性 | X | [问题描述] |
+| 可靠性 | X | [问题描述] |
+| 效率 | X | [问题描述] |
+
+### 优化建议
+
+1. [建议1]
+2. [建议2]
+...
+
+### 优化后的提示词
+
+```
+[优化后的完整提示词]
+```
+
+### 优化说明
+
+[解释做了哪些改动以及为什么]
+
+---
+
+## 待优化的提示词
+
+[用户在此粘贴待优化的提示词]
+```
+
+## 使用示例
+
+**输入**:
+```
+帮我写代码
+```
+
+**输出**:
+```
+### 诊断报告
+| 维度 | 评分 | 问题 |
+|:---|:---|:---|
+| 清晰度 | 1 | 没有说明写什么代码 |
+| 完整性 | 1 | 缺少语言、功能、约束等信息 |
+...
+
+### 优化后的提示词
+你是一个专业的软件工程师。请根据以下需求编写代码：
+- 编程语言: [指定语言]
+- 功能需求: [具体描述]
+- 约束条件: [性能/安全/风格要求]
+- 输出格式: [代码+注释+使用说明]
+```
+
+## 注意事项
+
+- 保留原提示词的核心意图
+- 优化应该是渐进式的，不要完全重写
+- 提供清晰的优化理由
--- a/i18n/zh/prompts/meta_prompts/prompt-template.md
+++ b/i18n/zh/prompts/meta_prompts/prompt-template.md
@ -0,0 +1,83 @@
+# 提示词规范化模板
+
+## 元信息
+- 版本: v1.0
+- 更新: 2025-12-19
+- 标签: [template, standard]
+
+## 目的
+
+提供标准化的提示词编写模板，确保提示词质量和一致性。
+
+---
+
+## 模板正文
+
+```markdown
+# [提示词名称]
+
+## 元信息
+- 版本: v1.0
+- 作者: [作者]
+- 更新: YYYY-MM-DD
+- 标签: [tag1, tag2, ...]
+
+## 目的
+
+[一句话描述这个提示词的用途]
+
+## 输入
+
+- 必需: [必需的输入内容]
+- 可选: [可选的输入内容]
+
+## 输出
+
+[期望的输出格式和内容]
+
+## 提示词正文
+
+```
+[实际的提示词内容]
+```
+
+## 使用示例
+
+### 示例 1
+
+**输入**:
+```
+[示例输入]
+```
+
+**输出**:
+```
+[示例输出]
+```
+
+## 注意事项
+
+- [注意点 1]
+- [注意点 2]
+
+## 相关资源
+
+- [相关链接或文档]
+```
+
+---
+
+## 使用说明
+
+1. 复制上方模板
+2. 替换 `[占位符]` 为实际内容
+3. 删除不需要的可选部分
+4. 确保至少有一个使用示例
+
+## 质量检查清单
+
+- [ ] 目的描述清晰（一句话）
+- [ ] 输入/输出明确
+- [ ] 提示词正文完整可用
+- [ ] 至少一个使用示例
+- [ ] 标签准确
--- a/i18n/zh/skills/headless-cli/SKILL.md
+++ b/i18n/zh/skills/headless-cli/SKILL.md
@ -0,0 +1,153 @@
+---
+name: headless-cli
+description: "无头模式 AI CLI 调用技能：支持 Gemini/Claude/Codex 等 CLI 的无交互批量调用，包含 YOLO 模式和安全模式。用于批量翻译、代码审查、多模型编排等场景。"
+---
+
+# Headless CLI 技能
+
+无交互批量调用 AI CLI 工具，支持 stdin/stdout 管道，实现自动化工作流。
+
+## When to Use This Skill
+
+触发条件：
+- 需要批量处理文件（翻译、审查、格式化）
+- 需要在脚本中调用 AI 模型
+- 需要多模型串联/并联处理
+- 需要无人值守的 AI 任务执行
+
+## Not For / Boundaries
+
+不适用于：
+- 需要交互式对话的场景
+- 需要实时反馈的任务
+- 敏感操作（YOLO 模式需谨慎）
+
+必需输入：
+- 已安装对应 CLI 工具
+- 已完成身份认证
+- 网络代理配置（如需）
+
+## Quick Reference
+
+### 🔴 YOLO 模式（全权限，跳过确认）
+
+**Codex CLI (GPT-5.1)**
+```bash
+alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
+```
+
+**Claude Code**
+```bash
+alias cc='claude --dangerously-skip-permissions'
+```
+
+**Gemini CLI**
+```bash
+alias g='gemini --yolo'
+```
+
+### 🟢 安全模式（无头但有限制）
+
+**Gemini CLI（禁用工具调用）**
+```bash
+cat input.md | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' "prompt" > output.md
+```
+
+**Claude Code（指定模型）**
+```bash
+cat input.md | claude -m claude-sonnet-4 --output-format text "prompt" > output.md
+```
+
+### 📋 常用命令模板
+
+**批量翻译**
+```bash
+# 设置代理（如需）
+export http_proxy=http://127.0.0.1:9910
+export https_proxy=http://127.0.0.1:9910
+
+# Gemini 翻译
+cat zh.md | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' \
+  "Translate to English. Keep code/links unchanged." > en.md
+```
+
+**代码审查**
+```bash
+cat code.py | claude --dangerously-skip-permissions \
+  "Review this code for bugs and security issues. Output markdown." > review.md
+```
+
+**多模型编排**
+```bash
+# 模型 A 生成 → 模型 B 审查
+cat spec.md | gemini -m gemini-2.5-flash --output-format text "Generate code" | \
+  claude -m claude-sonnet-4 "Review and improve this code" > result.md
+```
+
+### ⚙️ 关键参数说明
+
+| CLI | 参数 | 说明 |
+|:---|:---|:---|
+| gemini | `--yolo` | 跳过所有确认 |
+| gemini | `--allowed-tools ''` | 禁用工具调用（纯文本输出） |
+| gemini | `--output-format text` | 输出纯文本 |
+| gemini | `-m <model>` | 指定模型 |
+| claude | `--dangerously-skip-permissions` | 跳过权限确认 |
+| codex | `--dangerously-bypass-approvals-and-sandbox` | 跳过审批和沙箱 |
+| codex | `-c model_reasoning_effort="high"` | 高推理强度 |
+
+## Examples
+
+### Example 1: 批量翻译文档
+
+**输入**: 中文 Markdown 文件
+**步骤**:
+```bash
+export http_proxy=http://127.0.0.1:9910
+export https_proxy=http://127.0.0.1:9910
+
+for f in docs/*.md; do
+  cat "$f" | timeout 120 gemini -m gemini-2.5-flash --output-format text --allowed-tools '' \
+    "Translate to English. Keep code fences unchanged." 2>/dev/null > "en_$(basename $f)"
+done
+```
+**预期输出**: 翻译后的英文文件
+
+### Example 2: 代码审查流水线
+
+**输入**: Python 代码文件
+**步骤**:
+```bash
+cat src/*.py | claude --dangerously-skip-permissions \
+  "Review for: 1) Bugs 2) Security 3) Performance. Output markdown table." > review.md
+```
+**预期输出**: Markdown 格式的审查报告
+
+### Example 3: 多模型对比验证
+
+**输入**: 技术问题
+**步骤**:
+```bash
+question="How to implement rate limiting in Python?"
+
+echo "$question" | gemini -m gemini-2.5-flash --output-format text > gemini_answer.md
+echo "$question" | claude -m claude-sonnet-4 --output-format text > claude_answer.md
+
+# 对比两个答案
+paste gemini_answer.md claude_answer.md | diff -y --suppress-common-lines
+```
+**预期输出**: 两个模型答案的对比
+
+## References
+
+- `references/gemini-cli.md` - Gemini CLI 完整参数
+- `references/claude-cli.md` - Claude Code CLI 参数
+- `references/codex-cli.md` - Codex CLI 参数
+- [Gemini CLI 官方文档](https://github.com/google-gemini/gemini-cli)
+- [Claude Code 官方文档](https://docs.anthropic.com/claude-code)
+
+## Maintenance
+
+- 来源: 各 CLI 官方文档
+- 更新: 2025-12-19
+- 限制: 需要网络连接和有效认证；YOLO 模式有安全风险
--- a/i18n/zh/skills/headless-cli/references/claude-cli.md
+++ b/i18n/zh/skills/headless-cli/references/claude-cli.md
@ -0,0 +1,56 @@
+# Claude Code CLI 参数参考
+
+## 安装
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+## 认证
+
+需要 Anthropic API Key 或 Claude Pro 订阅。
+
+## 核心参数
+
+| 参数 | 说明 | 示例 |
+|:---|:---|:---|
+| `-m, --model` | 指定模型 | `-m claude-sonnet-4` |
+| `--output-format` | 输出格式 | `--output-format text` |
+| `--dangerously-skip-permissions` | 跳过权限确认 | 见下方 |
+| `/init` | 初始化项目规则 | |
+| `/rewind` | 回退到之前状态 | |
+| `/clear` | 清除上下文 | |
+| `/compact` | 压缩上下文（保留历史） | |
+
+## 可用模型
+
+- `claude-sonnet-4` - 平衡模型
+- `claude-opus-4` - 最强模型
+- `claude-opus-4.5` - 最新最强
+
+## 无头模式用法
+
+```bash
+# 基础无头调用
+cat input.txt | claude -m claude-sonnet-4 --output-format text "Your prompt"
+
+# YOLO 模式（跳过所有权限确认）
+claude --dangerously-skip-permissions "Your prompt"
+
+# 别名设置
+alias cc='claude --dangerously-skip-permissions'
+```
+
+## 深度思考触发词
+
+强度递增：
+- `think` - 基础思考
+- `think hard` - 深入思考
+- `think harder` - 更深入
+- `ultrathink` - 最深度思考
+
+## 常见问题
+
+1. **权限弹窗**: 使用 `--dangerously-skip-permissions`
+2. **上下文过长**: 使用 `/compact` 或 `/clear`
+3. **回退更改**: 使用 `/rewind`
--- a/i18n/zh/skills/headless-cli/references/codex-cli.md
+++ b/i18n/zh/skills/headless-cli/references/codex-cli.md
@ -0,0 +1,61 @@
+# Codex CLI 参数参考
+
+## 安装
+
+```bash
+npm install -g @openai/codex-cli
+```
+
+## 认证
+
+需要 OpenAI API Key 或 ChatGPT Plus 订阅。
+
+## 核心参数
+
+| 参数 | 说明 | 示例 |
+|:---|:---|:---|
+| `-m, --model` | 指定模型 | `-m gpt-5.1-codex-max` |
+| `--enable` | 启用功能 | `--enable web_search_request` |
+| `-c` | 配置选项 | `-c model_reasoning_effort="high"` |
+| `--dangerously-bypass-approvals-and-sandbox` | 跳过审批和沙箱 | 见下方 |
+| `--yolo` | YOLO 模式 | `--yolo` |
+
+## 可用模型
+
+- `gpt-5.1-codex` - 标准模型
+- `gpt-5.1-codex-max` - 最强模型
+- `gpt-5.1-codex-xhigh` - 超高性能
+
+## 推理强度配置
+
+```bash
+-c model_reasoning_effort="low"    # 快速
+-c model_reasoning_effort="medium" # 平衡
+-c model_reasoning_effort="high"   # 深度
+```
+
+## 无头模式用法
+
+```bash
+# 基础调用
+codex -m gpt-5.1-codex "Your prompt"
+
+# YOLO 模式（跳过所有确认）
+codex --yolo "Your prompt"
+
+# 完整 YOLO 配置
+codex --enable web_search_request \
+  -m gpt-5.1-codex-max \
+  -c model_reasoning_effort="high" \
+  --dangerously-bypass-approvals-and-sandbox \
+  "Your prompt"
+
+# 别名设置
+alias c='codex --enable web_search_request -m gpt-5.1-codex-max -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox'
+```
+
+## 常见问题
+
+1. **审批弹窗**: 使用 `--dangerously-bypass-approvals-and-sandbox`
+2. **需要联网**: 使用 `--enable web_search_request`
+3. **推理不够深**: 使用 `-c model_reasoning_effort="high"`
--- a/i18n/zh/skills/headless-cli/references/gemini-cli.md
+++ b/i18n/zh/skills/headless-cli/references/gemini-cli.md
@ -0,0 +1,53 @@
+# Gemini CLI 参数参考
+
+## 安装
+
+```bash
+npm install -g @anthropic-ai/gemini-cli
+```
+
+## 认证
+
+首次运行会引导 Google 账号登录。
+
+## 核心参数
+
+| 参数 | 说明 | 示例 |
+|:---|:---|:---|
+| `-m, --model` | 指定模型 | `-m gemini-2.5-flash` |
+| `--output-format` | 输出格式 (text/json) | `--output-format text` |
+| `--allowed-tools` | 允许的工具 | `--allowed-tools ''` (禁用所有) |
+| `--yolo` | YOLO 模式，跳过所有确认 | `--yolo` |
+| `--sandbox` | 沙箱模式 | `--sandbox` |
+
+## 可用模型
+
+- `gemini-2.5-flash` - 快速模型
+- `gemini-2.5-pro` - 高级模型
+- `gemini-3.0-pro` - 最新模型
+
+## 无头模式用法
+
+```bash
+# 基础无头调用
+cat input.txt | gemini -m gemini-2.5-flash --output-format text "Your prompt"
+
+# 禁用工具调用（纯文本输出）
+cat input.txt | gemini -m gemini-2.5-flash --output-format text --allowed-tools '' "Your prompt"
+
+# YOLO 模式（跳过所有确认）
+gemini --yolo "Your prompt"
+```
+
+## 代理配置
+
+```bash
+export http_proxy=http://127.0.0.1:9910
+export https_proxy=http://127.0.0.1:9910
+```
+
+## 常见问题
+
+1. **MCP 初始化慢**: 使用 `--allowed-tools ''` 跳过
+2. **超时**: 使用 `timeout` 命令包装
+3. **输出包含日志**: 重定向 stderr `2>/dev/null`
--- a/i18n/zh/skills/headless-cli/references/index.md
+++ b/i18n/zh/skills/headless-cli/references/index.md
@ -0,0 +1,13 @@
+# Headless CLI References
+
+## 目录
+
+- [gemini-cli.md](./gemini-cli.md) - Gemini CLI 详细参数
+- [claude-cli.md](./claude-cli.md) - Claude Code CLI 参数
+- [codex-cli.md](./codex-cli.md) - Codex CLI 参数
+
+## 外部链接
+
+- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
+- [Claude Code Docs](https://docs.anthropic.com/claude-code)
+- [Codex CLI Docs](https://platform.openai.com/docs/codex)
--- a/i18n/zh/skills/meta-skills/SKILL.md
+++ b/i18n/zh/skills/meta-skills/SKILL.md
@ -0,0 +1,139 @@
+---
+name: meta-skills
+description: "元技能：生成和优化 Skills 的技能。用于创建新 Skill、重构现有 Skill、建立技能标准。"
+---
+
+# Meta-Skills 元技能
+
+生成、优化和管理 Skills 的元级技能。
+
+## When to Use This Skill
+
+触发条件：
+- 需要创建新的 Skill
+- 需要重构/优化现有 Skill
+- 需要建立 Skill 编写标准
+- 需要验证 Skill 质量
+
+## Not For / Boundaries
+
+不适用于：
+- 直接执行领域任务（这是领域 Skill 的职责）
+- 凭空发明事实（必须基于材料）
+
+必需输入：
+- 领域材料（文档/API/代码/规范）
+- 或现有 Skill 文件
+
+## Quick Reference
+
+### Skill 目录结构
+
+```
+skill-name/
+├── SKILL.md              # 必需：入口文件
+├── references/           # 可选：长文档
+│   └── index.md          # 导航索引
+├── scripts/              # 可选：辅助脚本
+└── assets/               # 可选：模板/配置
+```
+
+### SKILL.md 最小模板
+
+```markdown
+---
+name: skill-name
+description: "[领域]能力：包含[能力1]、[能力2]。当[触发条件]时使用。"
+---
+
+# skill-name Skill
+
+一句话说明边界和交付物。
+
+## When to Use This Skill
+
+触发条件：
+- [触发1]
+- [触发2]
+
+## Not For / Boundaries
+
+- [不做什么]
+- [必需输入]
+
+## Quick Reference
+
+### 常用模式
+
+**模式1:** 说明
+```
+[可直接使用的命令/代码]
+```
+
+## Examples
+
+### Example 1
+- 输入:
+- 步骤:
+- 预期输出:
+
+## References
+
+- `references/index.md`
+
+## Maintenance
+
+- 来源: [文档/仓库]
+- 更新: YYYY-MM-DD
+- 限制: [已知限制]
+```
+
+### 质量检查清单
+
+1. `name` 匹配 `^[a-z][a-z0-9-]*$`
+2. `description` 包含"做什么+何时用"
+3. 有 "When to Use" 和 "Not For"
+4. Quick Reference ≤ 20 个模式
+5. ≥ 3 个可复现示例
+6. 长内容在 `references/`
+
+## Examples
+
+### Example 1: 从文档创建 Skill
+
+**输入**: 官方文档 + 代码示例
+**步骤**:
+1. 创建目录 `skills/<skill-name>/`
+2. 编写 frontmatter `description`
+3. 提取 10-20 个高频模式到 Quick Reference
+4. 添加 ≥3 个端到端示例
+5. 长内容移到 `references/`
+
+### Example 2: 重构臃肿 Skill
+
+**输入**: 现有的长 SKILL.md
+**步骤**:
+1. 识别模式 vs 长文解释
+2. 长文移到 `references/`
+3. Quick Reference 只保留可复制的模式
+4. 添加 "Not For / Boundaries"
+
+### Example 3: 验证 Skill 质量
+
+**输入**: `skills/<skill-name>/`
+**步骤**:
+1. 检查 frontmatter 格式
+2. 检查必需章节
+3. 检查示例数量
+4. 检查 references 导航
+
+## References
+
+- [claude-skills 元技能](../claude-skills/SKILL.md) - 完整的 Skill 规范
+- [skill-template.md](./skill-template.md) - 技能模板
+
+## Maintenance
+
+- 来源: claude-skills 规范
+- 更新: 2025-12-19
+- 限制: 模板是建议性的，可根据需要调整
--- a/i18n/zh/skills/meta-skills/skill-template.md
+++ b/i18n/zh/skills/meta-skills/skill-template.md
@ -0,0 +1,118 @@
+# 技能规范化模板
+
+## 元信息
+- 版本: v1.0
+- 更新: 2025-12-19
+
+---
+
+## 模板正文
+
+```markdown
+---
+name: [skill-name]
+description: "[领域]能力：包含[能力1]、[能力2]。当[触发条件]时使用。"
+---
+
+# [skill-name] Skill
+
+[一句话说明边界和交付物]
+
+## When to Use This Skill
+
+触发条件：
+- [触发条件1：具体任务/关键词]
+- [触发条件2]
+- [触发条件3]
+
+## Not For / Boundaries
+
+不适用于：
+- [不做什么1]
+- [不做什么2]
+
+必需输入：
+- [必需输入1]
+- [必需输入2]
+
+## Quick Reference
+
+### [分类1]
+
+**模式1:** [一行说明]
+```
+[可直接复制使用的命令/代码]
+```
+
+**模式2:** [一行说明]
+```
+[可直接复制使用的命令/代码]
+```
+
+### [分类2]
+
+...
+
+## Examples
+
+### Example 1: [场景名称]
+
+**输入**: [输入描述]
+**步骤**:
+1. [步骤1]
+2. [步骤2]
+3. [步骤3]
+**预期输出**: [输出描述/验收标准]
+
+### Example 2: [场景名称]
+
+...
+
+### Example 3: [场景名称]
+
+...
+
+## References
+
+- `references/index.md` - 导航索引
+- `references/[topic].md` - [主题说明]
+- [外部链接](https://example.com) - [说明]
+
+## Maintenance
+
+- 来源: [文档/仓库/规范]
+- 更新: YYYY-MM-DD
+- 限制: [已知限制和边界情况]
+```
+
+---
+
+## 使用说明
+
+1. 复制上方模板
+2. 替换 `[占位符]` 为实际内容
+3. `name` 必须是小写字母+数字+连字符
+4. `description` 必须包含"做什么"和"何时用"
+5. 至少提供 3 个示例
+
+## 目录结构
+
+```
+skill-name/
+├── SKILL.md              # 必需
+├── references/           # 可选
+│   ├── index.md          # 推荐
+│   └── [topic].md
+├── scripts/              # 可选
+└── assets/               # 可选
+```
+
+## 质量检查
+
+- [ ] name 格式正确
+- [ ] description 包含触发关键词
+- [ ] 有 When to Use
+- [ ] 有 Not For / Boundaries
+- [ ] Quick Reference ≤ 20 模式
+- [ ] ≥ 3 个示例
+- [ ] 长内容在 references/