Create Claude Code Skills（0xRaduan）— 从需求对话到脚本化技能的全流程

技能简介

Create Claude Code Skills 是 0xRaduan 开源的技能构建方法论，特色在于"先问后写"：通过一组澄清问题确定技能的用途、触发条件与范围，再进入 SKILL.md 的撰写。它同时覆盖三种技能形态——纯指导型、脚本增强型、引用支撑型，并提供基于 uv 与 PEP 723 元数据的 Python 脚本模板，帮助作者在需要自动化时写出规范、可审查的辅助脚本。该技能风险等级 safe、质量分 79，出自作者公开的 personal-os 仓库，适合希望把个人与团队工作流系统化沉淀为 Agent 技能的开发者。

核心能力

• 澄清式需求挖掘：用结构化问题先确定技能目的、触发场景与边界，防止技能定位失焦。
• SKILL.md 撰写指导：覆盖 description、frontmatter、指令正文与示例的完整写法。
• 三形态结构选型：指导作者在简单型、脚本型、引用型三种布局间做选择，避免过度设计。
• PEP 723 脚本模板：提供用 uv 运行的单文件 Python 脚本模板，含标准元数据头，开箱即用。
• 测试与迭代流程：说明激活测试、验证步骤与后续迭代的节奏，形成"写—测—改"闭环。

安装配置

• Skillstore CLI 安装：运行 npx skillstore add 0xraduan/skill-builder 安装。
• 手动安装：从 GitHub 仓库 0xRaduan/personal-os 的 skills/skill-builder 目录复制到本地技能路径。
• 脚本环境（可选）：若使用脚本增强型技能，需安装 uv 以运行 PEP 723 单文件脚本，纯指导型技能无此要求。
• 安全确认：技能标记了 scripts、external_commands、filesystem、env_access、network 多项风险因素，生成的脚本必须人工审查后再运行。

使用步骤

1. 发起澄清对话：调用技能后先回答它提出的用途、触发、范围问题，锁定技能目标。
2. 选择技能形态：判断任务只需指导、需要脚本自动化、还是需要引用长文档，对号入座选布局。
3. 撰写 SKILL.md：按技能给出的结构写 description、frontmatter、指令与示例，保持单一职责。
4. 补充脚本（如需）：套用 uv + PEP 723 模板编写辅助脚本，注明输入、输出与审查步骤。
5. 激活测试：用真实自然语言请求验证技能能否被正确触发，检查触发词是否过于宽泛。
6. 评审与迭代：审查脚本与依赖的安全性，按测试结果收敛触发条件与指令表述。

适用场景

• 个人工作流沉淀：把文档评审、测试分析、报告生成等重复任务做成个人技能。
• 团队技能标准化：创建项目级共享技能，统一触发词、文件位置、示例与维护说明。
• 脚本化自动化决策：判断某个任务该用纯指令解决还是该配脚本，避免"为了脚本而脚本"。
• 既有技能改造：对触发不准、结构臃肿的存量技能做结构与安全说明的翻新。
• 技能编写教学：作为新手入门的引导流程，边问边写建立正确的技能设计习惯。

适用人群

• 个人开发者：想把日常重复操作打包成技能的效率型用户。
• 开源作者：准备发布技能到 Skillstore 或团队仓库的贡献者。
• 技术负责人：为团队设计共享技能规范与脚本使用边界的管理者。
• Agent 自动化爱好者：正在探索"指令 + 脚本"混合技能形态的进阶用户。

工作原理

技能遵循"发现—设计—创建—交接"四阶段流程。发现阶段用澄清问题把模糊需求收敛成明确的技能目的与触发条件；设计阶段根据任务复杂度在三种布局中选型——简单任务用纯指令、需要确定性执行的用脚本、知识密集的拆引用文件；创建阶段产出 SKILL.md 与可选脚本，脚本统一采用 PEP 723 内联元数据，可用 uv 单命令运行，无需搭建虚拟环境；交接阶段通过激活测试与安全审查完成验收。它明确不代跑脚本、不校验市场政策，把最终审查权留给人，这种设计在提供便利的同时守住了安全边界。

官方链接

• Skillstore 页面：https://skillstore.io/skills/0xraduan-skill-builder
• GitHub 仓库：https://github.com/0xRaduan/personal-os/tree/master/skills/skill-builder
• Manifest：https://skillstore.io/api/skills/0xraduan-skill-builder/manifest
• 安装命令：npx skillstore add 0xraduan/skill-builder