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外部依赖
| 类型 | 依赖 |
|---|---|
| cli | python3 |
| package | PyYAML（解析 frontmatter） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 校验器只做结构/命名校验，不校验描述语义。 — quick_validate.py 用正则与长度检查 name/description，恶意或误导性描述可通过。
- 脚本会在文件系统写入用户指定路径。 — init_skill.py 建目录并写文件、package_skill.py 打包；路径来自用户输入，需注意目标目录。
- 打包产物直接分发，无内容审计。 — package_skill.py 校验通过即 zip 全部文件，不检查脚本内容或安全面。
判定 🔵 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 成立。
6结论
适合：要创建或迭代 agent skill 的作者：需要标准目录结构、frontmatter 规范、脚手架与打包工具的流程化支持。
不适合：只想快速写一段提示词、无需打包分发的场景；需要强安全审计（脚本内容审查）发布的场合；非 skills 兼容宿主。
安装 agent 直装可复制
① 本站镜像 更新 2026-10-10
方式 A · 人下载镜像包下载 skill-creator.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent0b2639ac219971bd…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库freestylefly / freestylefly/canghe-skills
原始 GitHubfreestylefly/canghe-skills ↗
本 skill commit
dd0bf35595许可MIT（仓库根 LICENSE）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。