一念成技（Idea → Skill）

一、价值与定位

任何人都会积累可复用的「经验、流程、偏好、方法论」——比如一套文案润色流程、一种文件归档习惯、一段排错 checklist。这些东西最该被沉淀成 Skill，让 AI 在任意干净环境里都能照做执行，而不必每次重新描述。

本 Skill 提供一套标准化流水线，把一个模糊或清晰的想法，锻造成：
- 一份通用、去个性化的 SKILL.md（结构完整、可直接安装使用）；
- 一份面向新用户的 USAGE.md（使用说明）；
- 3–5 个吸引人的中文名 + 唯一技术名备选；
- 并通过红蓝对抗 + 新用户环境测试保证质量。

> 本 Skill 是「Skill 生产工具」，不直接执行业务任务，只负责把想法变成 Skill。

二、触发词

• "帮我把这个想法做成 Skill" / "把需求变成 Skill" / "我想做个 Skill"
• "把这套流程沉淀成 Skill" / "给我造一个 Skill" / "把经验写成 Skill"

三、适用边界

适合做成 Skill 的想法：
- 可用文字完整描述的流程、规则、偏好、方法论；
- 高频复用、跨项目/跨会话通用；
- 不依赖专属二进制、外部付费服务或强状态才能跑（纯提示词/流程类最佳）。

部分适合（仅内化流程，标注工具依赖）：
- 流程清晰，但执行时需要某个工具/MCP 配合——把流程写进 Skill，并明确标注「需启用 XX 工具/MCP」。

不适合（应换方案或明确标注）：
- 必须依赖一段专属代码/脚本且无法用提示词表达核心逻辑；
- 强状态、需持久会话或外部账户才能运行的部分。
此类应说明限制，或建议改用语/代码方案。

四、工作流程（含红蓝对抗）

Step 1 · 明确需求与边界

确认任务是「仅出方案说明」还是「直接产出 Skill 文件」；涉及对外/实质操作前先与用户确认。

Step 2 · 红蓝对抗设计（强制）

• 红军（设计）：提出主干流程——识别候选能力 → 提炼四要素（触发/流程/注意/红线）→ 去个性化 → 编写 → 测试。
• 蓝军（挑刺），重点排查：
  1. 多规则互相矛盾；
  2. 参考的原 Skill 升级后，本 Skill 内容过时；
  3. 过度融合导致规则臃肿、失去重点；
  4. 编写前缺安全审查；
  5. 带专属工具/MCP、无法纯规则复现的部分被误写成「已搞定」；
  6. 适用边界不清，让人误用到不合适场景。
• 优化落点：把安全审查（P0/P1/P2）、冲突检测、去重、来源+版本注释、适用边界固化进 Skill 结构。

> 红蓝对抗是单轮自检方法论，由 AI 同轮完成：红军设计 + 蓝军挑刺 + 优化，不另起角色。

Step 3 · 编写 SKILL.md（去个性化）

结构建议：
- frontmatter：name(kebab-case 唯一)、description、version
- 标题与价值定位
- 触发词
- 适用边界
- 工作流程 / 标准步骤
- 注意事项 / 红线
- 与原参考的关系（增强而非替代）

Step 4 · 编写 USAGE.md

面向新用户、步骤化、可直接照做；说明何时用、怎么装、怎么触发、注意事项。

Step 5 · 生成名称备选

提供 3–5 个吸引人中文名 + 1 个推荐技术名（kebab-case，须唯一）。

Step 6 · 模拟新用户环境测试

• 去个性化校验：搜索个人名/昵称/专属产品名/绝对路径 → 应零匹配；
• 结构校验：frontmatter 完整、无 [TODO]、流程自洽；
• 加载校验（若已安装到 Skills 目录）：用典型触发语加载，确认返回完整指令、无歧义；
• 结论必须明确：「新用户可顺畅执行 ✅ / 不可 ❌」。

Step 7 · 归档落盘

按下方「归档规则」写入，旧版留存历史版本，不覆盖。

五、去个性化清单（R1）

编写时必须剔除：
- 个人/团队人名、昵称、人设标签；
- 特定产品名（某网盘、某文档平台、某 IM 等专属词）；
- 绝对路径（如 /Users/xxx/...）；
- 任何仅适用于单一用户环境的写死配置。
统一用通用表述（如「用户级全局规则文件」「桌面存档目录」并可自定义）。

六、安全审查（P0/P1/P2）

• P0（严禁）：包含可疑命令（rm -rf、未限定的 curl/管道、未授权外发）、索取敏感凭证、诱导删除原文件当作「已内化」。发现即强警告并要求确认。
• P1（警告）：涉及外部写入、网络请求、修改系统配置——需明确告知用户并获得同意。
• P2（安全）：纯本地、只读、无外部依赖——可直接进行。

七、12 条强制规则（本 Skill 自制 Skill 时遵守）

• R1 通用化去标签：去除个人规则标签与各类软件/平台标签，输出通用可用版。
• R2 红蓝对抗前置：初步思路形成后先做红蓝对抗提前优化，避免重复修改。
• R3 交付物完整：每 Skill 必含 (a) SKILL.md (b) 使用说明 (c) 3–5 个吸引人中文名备选 + 技术名。
• R4 新用户测试：制成后模拟新用户环境测试，过程简化，结果明确告知能否顺畅执行。
• R5 版本留存：改旧版需说明对比点；新版本不覆盖旧版，旧版留存历史版本。
• R6 文字质检：文字型产出复核错别字等常规问题。
• R7 不确定即问：不确定内容务必询问，不模糊处理。
• R8 先介绍后执行：用户仅要「文字说明/介绍」时先介绍，确认后再执行；对外/实质操作前确认。
• R9 结果汇报：任务完毕简述发现问题、修改方式、修改结果。
• R10 命名唯一：技术名须唯一，避免与已有 Skill 冲突（发布前先检索）。
• R11 文件夹归档：默认根目录桌面「新建SKILLS」（可自定义）；新 Skill → 新建对应名称文件夹；同一 Skill 更新 → 放对应文件夹，旧版存「历史版本/Vn」。
• R12 同版本文件同文件夹：同一版本的所有文件（SKILL.md、USAGE.md 等）放在同一文件夹内，避免混淆。

八、红线禁止项

• 禁止把个人/专属标签写死进通用 Skill；
• 禁止跳过红蓝对抗与去个性化直接交付；
• 禁止删除原 Skill/原文件当作「已内化/已完成」；
• 禁止未做安全审查就产出可能执行危险操作的 Skill；
• 禁止技术名与已有 Skill 重复发布（造成双实例歧义）；
• 禁止伪造「新用户测试通过」结论。

九、归档规则（R11/R12）

默认根目录：桌面「新建SKILLS」（用户可自定义为任意目录）。
- 新 Skill → 新建以 Skill 名称命名的文件夹；
- 同一 Skill 更新 → 放入对应文件夹，旧版归档至 「历史版本/Vn」 子文件夹，不覆盖旧版；
- 同一版本的所有文件（SKILL.md、USAGE.md 等）放在同一文件夹内，避免混淆。

十、跨平台兼容性说明（R15 强制）

本 Skill 是纯提示词流程，零脚本、零 MCP、零外部付费服务依赖——只要智能体支持「加载自定义 Skill / 系统指令」，下载后功能 100% 完整可用，不绑定任何单一平台。

• frontmatter 通用：name 与 description 是各平台统一读取的触发字段；platforms、slug、agent_created 等扩展字段对非 WorkBuddy 平台无害（平台忽略不识别的字段，不会报错）。
• 各平台 skills 目录（把本 Skill 文件夹放入对应目录即可）：
• WorkBuddy：~/.workbuddy/skills/skill-forge/
• Claude：~/.claude/skills/skill-forge/
• Cursor：~/.cursor/skills/skill-forge/
• Codex：~/.codex/skills/skill-forge/
• Windsurf：~/.windsurf/skills/skill-forge/
• Gemini：~/.gemini/skills/skill-forge/
• Copilot：~/.copilot/skills/skill-forge/
• OpenClaw：~/.openclaw/skills/skill-forge/
• 目录命名建议：文件夹名用本 Skill 的英文 slug skill-forge（而非中文显示名），避免 Windows / 非 UTF-8 环境下中文目录名乱码。
• 归档默认目录：桌面「新建SKILLS」（用户可自定义为任意目录，不影响 Skill 功能）。