by 运行时依赖
安装命令
点击复制技能文档
技能标准化 —— Skill 标准化规范引擎 v2 基于 SKILL.md 标准化规范草案 v0.1，提供 Skill 全生命周期的标准化管理：
能力 说明 工具 创建 (create) 从模板初始化标准 skill skill_builder.py create 更新 (update) 增量规范化检查与修复 skill_builder.py update 改造 (refactor) 非标 skill 整体优化（信息零遗漏） skill_builder.py refactor 审查 (audit) R-01~R-10 自动审查 skill_audit.py audit 规范加载 渐进式 JSON 规范按需加载 json_loader.py load
触发场景 当用户提到以下任一意图时触发本技能： "创建/新建一个 skill"、"标准化创建 skill" "检查/审查/审计 SKILL.md" "更新/规范化已有 skill" "改造/重构/优化 skill 结构" "skill 是否符合标准/规范" "SKILL.md 标准化"、"skill 标准验证"
核心能力 # 功能 说明 1 三种执行模式 create / update / refactor 覆盖 skill 全生命周期 2 10 条自动审查规则 R-01R-04 (ERROR) + R-05R-10 (WARN)，纯警告不阻断 3 标准目录结构规范 根目录仅 SKILL.md + _meta.json，三级复杂度布局 4 渐进式 MD 文件体系 主文件 ≤200 行核心，辅助内容拆分到 references/ 按需加载 5 零依赖 Python 工具 所有脚本仅使用标准库，跨平台兼容 6 信息完整性保障 refactor 模式强制备份 + 全量扫描 + 仅移动不删除 + 映射报告
快速开始 # 1. 创建新 skill（从模板） python scripts/skill_builder.py create my-skill --desc "我的技能" --tags tag1,tag2 # 2. 检查已有 skill 的规范化状态 python scripts/skill_builder.py update ~/.workbuddy/skills/my-skill # 3. 改造非标 skill 到标准结构（先 dry-run 看计划！） python scripts/skill_builder.py refactor ~/.workbuddy/skills/old-skill --dry-run # 4. 执行审查 python scripts/skill_audit.py audit ~/.workbuddy/skills/my-skill # 5. 加载规范定义 python scripts/json_loader.py load structure # 目录结构规范 python scripts/json_loader.py load progressive_md # 渐进式MD体系 python scripts/json_loader.py load all # 全部规范
三种执行模式详解 模式 A：create（创建） 从模板初始化一个新的完全符合标准的 skill。 何时使用： 用户要新建一个 skill 需要一个标准的 skill 骨架作为起点 执行流程： 输入: name + description(可选) + tags(可选) ↓ 生成标准目录: / ├── SKILL.md (含 frontmatter + TODO 占位符模板) ├── _meta.json (五字段元数据) ├── references/.gitkeep (渐进式MD目录) └── scripts/.gitkeep (脚本目录) ↓ 输出: 创建结果 + 后续指引 关键设计： SKILL.md 模板包含所有必填章节的占位符（TODO 标记清晰） 版本号从 0.1.0 开始，遵循 SemVer author 默认为 your-name-here 占位符（铁律1：不可擅自替换为具体人名） → 详见 references/guide.md 完整创建教程（按需编写）
模式 B：update（更新） 对已有的 skill 进行增量规范化检查和修复。 何时使用： 已有 skill 需要检查是否符合最新规范 需要补充缺失的字段或章节 检查项： 检查项 说明 可自动修复？ _meta.json 存在性和字段完整性 五字段齐全 SKILL.md frontmatter 存在性 以 --- 开头 必填章节完整性 触发场景/核心能力/快速开始 文件大小合理性 SKILL.md ≤ 200 行 根目录规范性 无散落文件 执行示例： # 仅查看检查报告 python scripts/skill_builder.py update ./my-skill # 自动修复可修复的问题 + 备份原文件 python scripts/skill_builder.py update ./my-skill --fix --backup
模式 C：refactor（改造） 对不符合标准的 skill 进行整体结构改造。 核心约束：信息零遗漏 安全保障机制：
- 强制备份（除非显式 --no-backup）
- 全量扫描 → 文件清单（路径+大小+时间）
- 仅执行 move 操作（绝不 delete）
- 移动后验证总字节一致性（允许 1% 容差）
- 输出完整迁移映射表
- 失败时可从备份完整回滚
标准目录结构 加载命令：python scripts/json_loader.py load structure 根目录（必须且仅包含） 文件 必填 说明 SKILL.md 技能主文件（≤200 行，含核心章节） _meta.json 元数据（name/version/description/author/tags） 约定：根目录不应放置其他文件。 子目录（按需创建） / ├── SKILL.md # [必填] 主文件 ├── _meta.json # [必填] 元数据 │ ├── references/ # 渐进式 MD 辅助文档 │ ├── guide.md # 使用指南（详细教程） │ ├── examples.md # 示例集合 │ ├── reference.md # API/命令参考 │ ├── faq.md # 常见问题 │ └── ... # 其他 .md 文件 │ ├── scripts/ # 可执行脚本和工具 │ ├── .py / .sh # 脚本文件 │ └── spec/ # JSON 规格定义 │ ├── assets/ # [可选] 静态资源 │ └── images/ / templates/ │ └── tests/ # [可选] 测试 └── test_.py 三级复杂度 级别 适用场景 包含目录 示例 minimal 纯提示型 skill SKILL.md + _meta.json color-toolkit standard 有脚本或文档的 skill + scripts/ + references/ git-sync, triphasic-execution full 复杂工具型 skill + assets/ + tests/ —
渐进式 MD 文件体系 加载命令：python scripts/json_loader.py load progressive_md 核心原则 主 SKILL.md 必须可独立理解核心功能和使用方法。 references/ 下的渐进式 .md 是按需加载的补充材料，缺失不影响基本使用。 拆分边界 主文件 SKILL.md 必须包含 拆分到 references/ 的渐进式 MD frontmatter 元数据 详细教程 (guide.md) 技能名称/一级标题 完整示例 (examples.md) 触发条件/适用场景 参考/API文档 (reference.md) 核心功能概述 FAQ常见问题 (faq.md) 快速开始（最简用法） 更新日志 (changelog.md) 架构设计 (architecture.md) 加载协议 用户任务 → AI 加载 SKILL.md（始终发生） ↓ 任务简单？ → 直接用 SKILL.md 执行 ↓ 否 任务复杂？ → 检查 SKILL.md 中的 references/ 引用 ↓ 按需读取 references/.md 补充决策 引用语法（在 SKILL.md 中指向渐进式 MD） → 详见 `