1实现原理 · 为什么它能做到

元技能：本身是「如何创建 skill」的指南，核心产物是一套流程规范 + 三个本地 Python 工具。

skills/skill-creator/SKILL.md

Skill creation involves these steps:

这里在做什么：把 skill 创建拆成六步可执行流程。

首要原则是「精简」：上下文窗口是公共资源，只补模型不知道的信息。

skills/skill-creator/SKILL.md

The context window is a public good.

这里在做什么：把 token 成本上升为设计约束，要求逐句质疑必要性。

按任务脆弱度选择自由度：多变场景用文本指令（高自由度），脆弱流程用带参脚本（低自由度）。

skills/skill-creator/SKILL.md

**High freedom (text-based instructions)**: Use when multiple approaches are valid, decisions depend on context, or heuristics guide the approach.

这里在做什么：给出「窄桥加护栏、旷野放任走」的类比来定实现形态。

规定 skill 目录解剖：必选 SKILL.md（frontmatter + 正文），可选 scripts/references/assets 三类资源。

skills/skill-creator/SKILL.md

Every skill consists of a required SKILL.md file and optional bundled resources:

这里在做什么：定义标准目录结构，三类资源的用途各有一节说明。

渐进式披露三级加载：metadata 常在上下文，正文触发后加载，资源按需加载。

skills/skill-creator/SKILL.md

Skills use a three-level loading system to manage context efficiently:

这里在做什么：解释为何要把细节移出 SKILL.md。

第三步用 init_skill.py 生成模板目录（SKILL.md + scripts/references/assets 示例文件）。

skills/skill-creator/SKILL.md

scripts/init_skill.py <skill-name> --path <output-directory>

这里在做什么：脚手架命令，实际执行的是随附脚本。

第五步用 package_skill.py 先校验再打包成 .skill（zip 格式）。

skills/skill-creator/SKILL.md

scripts/package_skill.py <path/to/skill-folder>

这里在做什么：交付环节，打包前自动跑校验。

明确禁止附带 README/INSTALLATION_GUIDE/CHANGELOG 等杂项文档，避免污染上下文。

skills/skill-creator/SKILL.md

Do NOT create extraneous documentation or auxiliary files, including:

这里在做什么：把「不要写什么」也写成硬规则。

2核心能力

01Skill 目录结构规范：SKILL.md（frontmatter+正文）+ scripts/references/assets

02六步创建流程：理解→规划→初始化→编辑→打包→迭代

03脚手架生成：init_skill.py 建目录并写 SKILL.md 模板 + 三个示例资源

04校验器：quick_validate.py 检查 frontmatter 字段白名单、命名规范、描述长度

05打包分发：package_skill.py 校验通过后打成 .skill（zip）

06设计模式参考：output-patterns.md（模板/示例）与 workflows.md（顺序/条件工作流）

07渐进式披露指导：SKILL.md 正文控制在 500 行内，细节外移到引用文件

08自由度分级指导：按任务脆弱度选择文本指令/带参脚本/固定脚本

3外部依赖

Kind	Dependency / Endpoint
cli	python3
package	PyYAML（解析 frontmatter）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

scripts/: 执行本地脚本或命令: scripts/init_skill.py
本地工作目录: 文件读写与工件输出: 创建 skill 目录与 SKILL.md

审计说明： 判定 🔵 blue：技能携带三个本地 Python 脚本，执行创建目录、写模板文件、打包 zip 等本地读写（§3 写盘 10 条命中 init_skill.py/package_skill.py）。§3 无网络请求、无凭证读取、无危险旗标。风险提醒：blue，常规使用；脚本按用户提供的路径在文件系统写入，注意目标目录。

5第二遍独立确认

[ok] 文件面核对 — §1 共 7 个文件：SKILL.md、LICENSE.txt、2 个 references、3 个 scripts，与 internal_assets 一致。
[ok] 脚本执行真伪 — §3「执行外部程序」无命中（脚本由模型按 SKILL.md 指示调用）；三个脚本源码实读确认存在。
[ok] 凭证读取反例 — §3 两条凭证命中经回原文核对为 SKILL.md 的 'challenge each' 文本与示例 'token validation middleware'，非 env/凭据读取，故 credential_reads 判空。
[ok] 写盘复核 — §3 写盘 10 条命中 init_skill.py（mkdir/write_text/chmod）与 package_skill.py（mkdir/zipf.write），与 file_writes 一致。
[ok] 网络与注入面 — §3 无 URL、无网络请求命中；注入面仅剩用户输入经 yaml.safe_load 解析的语义校验缺口（设计边界）。
[ok] 档位判定复核 — 本地脚本 + 本地读写、无网络无凭证 → 🔵 blue 成立。