Meta Skill Creator
English version: README.en.md
因合并关系,本仓库已迁入 Kim Service 合集,不再单独发布新版本。请前往 Kim Service 获取新版本、安装说明和更新记录。
Meta Skill Creator 是一个用来设计、重构、评审 Agent Skill 的技能包。
它不是“美化提示词”的工具。用户明确要创建、重构或评审 skill 时,它直接进入对应路线,再把这件事推进到领域研究、产品表面、包结构、验证、发布门禁和闭环写回。
一个合格的 skill 包不应该只看起来完整,还要能说明:它解决什么问题、读了什么证据、在哪里运行、怎么验证、失败后写回哪里。
仓库内容
| 路径 | 用途 |
|---|---|
skills/meta-skill-creator/ |
源 skill 包 |
skills/meta-skill-creator/SKILL.md |
轻量触发和路由入口 |
skills/meta-skill-creator/references/ |
领域、产品、评测、发布和闭环规则 |
skills/meta-skill-creator/assets/ |
包计划和运行记录模板 |
skills/meta-skill-creator/scripts/ |
包结构和闭环校验脚本 |
skills/meta-skill-creator/evals/ |
触发评测用例 |
skills/meta-skill-creator/examples/ |
小型输入/输出示例 |
docs/images/ |
联系方式和支持二维码 |
CONTRIBUTING.md |
维护流程和发布校验规则 |
方法
Critical Thinking -> Fetch -> Deep Thinking -> Review -> Loop
这个流程的重点是分清证明层级:
- Critical Thinking:先识别请求类型,明确创建请求直接进入创建路线。
- Fetch:读取会改变决策的证据,而不是凭熟悉样例套模板。
- Deep Thinking:设计包结构、产物链、工具路线和发布门禁。
- Review:区分结构校验、运行证据、产物证据和人工确认。
- Loop:写回、提案、延后或阻塞,不能把聊天总结冒充闭环。
顶级创建规则验收标准
顶级创建规则不是“更长的提示词”,而是能被执行和评审的阶段契约。完整标准见 skills/meta-skill-creator/references/creation-rule-standard.md。
| 阶段 | 必须产出 | 通过标准 |
|---|---|---|
| Critical Thinking | 任务类型、用户结果、范围、非目标、风险、第一证据路线 | 明确创建请求不会被否决,下一步是为正确设计取证而不是直接套模板写文件 |
| Fetch | 来源地图、已读证据、不可得证据、关键结论、反证、决策影响 | 每个关键设计判断都有证据或明确假设;需要联网时已联网 |
| Deep Thinking | 包合同、产物链、工具路线、文件写入位置、验收计划 | 每个新增文件或规则都绑定具体失败模式,并且验收可打勾 |
| Review | 校验命令、证明层级、产物/运行证据、ready 级别、闭环决策 | 不把结构通过当成质量通过;失败能进入回写、提案、延后或阻塞 |
最低门槛:没有阶段产物、没有 pass/fail 条件、没有失败处理和闭环决策的创建规则,不算合格。
联网深度研究怎么做
深度研究不是只读本地文件。只要任务涉及会变化的信息,就必须联网;例如平台规则、API/SDK、运行时能力、开源项目、竞品实践、政策合规、价格、模型能力、工具可用性和社区最佳实践。
一次合格的联网研究至少要产出:
- 来源地图:官方文档、开放标准、高信号项目、用户材料、失败案例和反证分别查了什么。
- 关键结论:哪些事实会改变 skill 的触发边界、产物链、工具路线、文件结构、评测或发布门禁。
- 反证和不确定性:哪些信息过期、冲突、不适用于当前宿主,或需要用户确认。
- 写入位置:结论进入
SKILL.md、references/、assets/、scripts/、evals/、examples/,还是只作为本次运行记录。
如果当前环境不能联网,必须写清楚“哪些在线来源不可用”。这时可以给出 research-needed、blocked 或带假设的设计草案,但不能宣称 ready。
什么能写进 Skill
研究结果必须先通过写入判断,不能把看到的资料直接塞进 skill:
| 写入位置 | 能写什么 | 不能写什么 |
|---|---|---|
SKILL.md |
触发边界、第一动作、硬停止、资源路由、验证口径 | 长篇研究、平台细节、一次性总结 |
references/ |
领域规则、证据模型、产物链、失败模式、发布门禁 | 未抽象的竞品结构、别人的话术、私有运行日志 |
assets/ |
可复用模板、brief、checklist、运行记录表 | 只对一次任务有用的草稿 |
scripts/ |
可重复、确定性的校验/转换/生成动作 | 需要模型自由发挥的判断 |
evals/ |
触发、误触发、近似输入、输出质量和回归用例 | 只证明“看起来不错”的样例 |
examples/ |
小而真实的输入/输出示例 | 私有客户信息、假运行证据、内部评分 |
写入的最低门槛:它必须能防止一个具体失败,或让下一次运行更稳定、更可验证。否则只记录为运行证据,不写进长期规则。
公开依据
- Anthropic: Equipping agents for the real world with Agent Skills
- Claude Agent Skills docs
- OpenAI Codex Agent Skills docs
- OpenAI API Skills docs
- OpenAI Prompt Guidance
- OpenAI Evaluation Best Practices
- Anthropic: Demystifying evals for AI agents
- Anthropic: Effective context engineering for AI agents
- Agent Skills open specification
安装
先把本仓库下载到本机,并进入仓库根目录。只有这个目录里才有 skills/meta-skill-creator。
Windows PowerShell:
git clone https://github.com/KimYx0207/meta-skill-creator.git
Set-Location meta-skill-creator
Test-Path .\skills\meta-skill-creator\SKILL.md
如果上面返回 True,再安装。
Claude Code 全局 skill:
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force -Path ".\skills\meta-skill-creator" -Destination "$env:USERPROFILE\.claude\skills\meta-skill-creator"
Codex 项目级 skill,安装到另一个项目:
$Project = "D:\codex_project\test-kim-skillcreater"
New-Item -ItemType Directory -Force -Path "$Project\.codex\skills" | Out-Null
Copy-Item -Recurse -Force -Path ".\skills\meta-skill-creator" -Destination "$Project\.codex\skills\meta-skill-creator"
Codex 兼容用户级 skill:
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills" | Out-Null
Copy-Item -Recurse -Force -Path ".\skills\meta-skill-creator" -Destination "$env:USERPROFILE\.agents\skills\meta-skill-creator"
macOS / Linux / Git Bash:
git clone https://github.com/KimYx0207/meta-skill-creator.git
cd meta-skill-creator
test -f skills/meta-skill-creator/SKILL.md
Claude Code 全局 skill:
mkdir -p ~/.claude/skills
cp -R skills/meta-skill-creator ~/.claude/skills/meta-skill-creator
Codex 项目级 skill,安装到当前项目:
mkdir -p .codex/skills
cp -R skills/meta-skill-creator .codex/skills/meta-skill-creator
Codex 兼容用户级 skill:
mkdir -p ~/.agents/skills
cp -R skills/meta-skill-creator ~/.agents/skills/meta-skill-creator
常见错误:如果当前目录不是本仓库根目录,skills/meta-skill-creator 就不存在。先 git clone,或者把 Copy-Item / cp 的源路径改成你下载好的仓库路径。
校验
在仓库根目录运行:
python skills/meta-skill-creator/scripts/check_meta_skill_package.py skills/meta-skill-creator
python skills/meta-skill-creator/scripts/check_closed_loop.py skills/meta-skill-creator
这些检查只能证明包结构和闭环契约存在,不能单独证明公开发布就绪。公开发布还需要干净会话验收、baseline 对比、真实产物/运行证据,以及人工评审。
质量标准
一个可用的 skill 包至少应该有:
- 轻入口但证据重的
SKILL.md - 先做领域研究,再做设计
- 必要时联网深度研究,并记录来源、关键结论和反证
- 明确的最终产物链路
- 触发评测和输出评测
- 至少一个非文档资产或确定性脚本
- 能区分结构、运行、产物、人工确认的发布门禁
- 闭环决策:
writeback、proposal、none-with-reason或blocked
联系方式
扫码联系作者。
微信公众号:老金带你玩AI
支持
如果 Meta Skill Creator 对你有帮助,可以请作者喝杯咖啡。
贡献
维护流程、编辑规则、原创边界和发布校验见 CONTRIBUTING.md。
No comments yet
Be the first to share your take.