From 5d29bcf51bb7133275ac4a4fdeb9c8d3d3a3ef36 Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Fri, 19 Dec 2025 13:41:45 +0800 Subject: [PATCH] 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) --- i18n/zh/prompts/meta_prompts/README.md | 30 ++++ .../prompts/meta_prompts/alpha-generator.md | 86 ++++++++++ .../prompts/meta_prompts/omega-optimizer.md | 104 ++++++++++++ .../prompts/meta_prompts/prompt-template.md | 83 ++++++++++ i18n/zh/skills/headless-cli/SKILL.md | 153 ++++++++++++++++++ .../headless-cli/references/claude-cli.md | 56 +++++++ .../headless-cli/references/codex-cli.md | 61 +++++++ .../headless-cli/references/gemini-cli.md | 53 ++++++ .../skills/headless-cli/references/index.md | 13 ++ i18n/zh/skills/meta-skills/SKILL.md | 139 ++++++++++++++++ i18n/zh/skills/meta-skills/skill-template.md | 118 ++++++++++++++ 11 files changed, 896 insertions(+) create mode 100644 i18n/zh/prompts/meta_prompts/README.md create mode 100644 i18n/zh/prompts/meta_prompts/alpha-generator.md create mode 100644 i18n/zh/prompts/meta_prompts/omega-optimizer.md create mode 100644 i18n/zh/prompts/meta_prompts/prompt-template.md create mode 100644 i18n/zh/skills/headless-cli/SKILL.md create mode 100644 i18n/zh/skills/headless-cli/references/claude-cli.md create mode 100644 i18n/zh/skills/headless-cli/references/codex-cli.md create mode 100644 i18n/zh/skills/headless-cli/references/gemini-cli.md create mode 100644 i18n/zh/skills/headless-cli/references/index.md create mode 100644 i18n/zh/skills/meta-skills/SKILL.md create mode 100644 i18n/zh/skills/meta-skills/skill-template.md diff --git a/i18n/zh/prompts/meta_prompts/README.md b/i18n/zh/prompts/meta_prompts/README.md new file mode 100644 index 0000000..12ad26a --- /dev/null +++ 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) diff --git a/i18n/zh/prompts/meta_prompts/alpha-generator.md b/i18n/zh/prompts/meta_prompts/alpha-generator.md new file mode 100644 index 0000000..df2e6b0 --- /dev/null +++ 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 代码的安全性和性能问题。 +``` + +**输出**: 生成符合模板的代码审查提示词 + +## 注意事项 + +- 生成的提示词应该是自包含的 +- 避免过于复杂的嵌套结构 +- 确保提示词可以直接复制使用 diff --git a/i18n/zh/prompts/meta_prompts/omega-optimizer.md b/i18n/zh/prompts/meta_prompts/omega-optimizer.md new file mode 100644 index 0000000..0b315a6 --- /dev/null +++ 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 | 缺少语言、功能、约束等信息 | +... + +### 优化后的提示词 +你是一个专业的软件工程师。请根据以下需求编写代码： +- 编程语言: [指定语言] +- 功能需求: [具体描述] +- 约束条件: [性能/安全/风格要求] +- 输出格式: [代码+注释+使用说明] +``` + +## 注意事项 + +- 保留原提示词的核心意图 +- 优化应该是渐进式的，不要完全重写 +- 提供清晰的优化理由 diff --git a/i18n/zh/prompts/meta_prompts/prompt-template.md b/i18n/zh/prompts/meta_prompts/prompt-template.md new file mode 100644 index 0000000..e03d14a --- /dev/null +++ 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. 确保至少有一个使用示例 + +## 质量检查清单 + +- [ ] 目的描述清晰（一句话） +- [ ] 输入/输出明确 +- [ ] 提示词正文完整可用 +- [ ] 至少一个使用示例 +- [ ] 标签准确 diff --git a/i18n/zh/skills/headless-cli/SKILL.md b/i18n/zh/skills/headless-cli/SKILL.md new file mode 100644 index 0000000..5cb14c2 --- /dev/null +++ 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 ` | 指定模型 | +| 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 模式有安全风险 diff --git a/i18n/zh/skills/headless-cli/references/claude-cli.md b/i18n/zh/skills/headless-cli/references/claude-cli.md new file mode 100644 index 0000000..4275601 --- /dev/null +++ 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` diff --git a/i18n/zh/skills/headless-cli/references/codex-cli.md b/i18n/zh/skills/headless-cli/references/codex-cli.md new file mode 100644 index 0000000..2ed707c --- /dev/null +++ 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"` diff --git a/i18n/zh/skills/headless-cli/references/gemini-cli.md b/i18n/zh/skills/headless-cli/references/gemini-cli.md new file mode 100644 index 0000000..b017446 --- /dev/null +++ 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` diff --git a/i18n/zh/skills/headless-cli/references/index.md b/i18n/zh/skills/headless-cli/references/index.md new file mode 100644 index 0000000..ea42fab --- /dev/null +++ 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) diff --git a/i18n/zh/skills/meta-skills/SKILL.md b/i18n/zh/skills/meta-skills/SKILL.md new file mode 100644 index 0000000..a5abcd2 --- /dev/null +++ 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//` +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//` +**步骤**: +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 +- 限制: 模板是建议性的，可根据需要调整 diff --git a/i18n/zh/skills/meta-skills/skill-template.md b/i18n/zh/skills/meta-skills/skill-template.md new file mode 100644 index 0000000..96ed912 --- /dev/null +++ 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/