biz-skill-creator

业务 Skill 全生命周期管理工具——从需求深挖到测试验证，一站式创建高质量业务 Skill。

基于 Anthropic skill-creator 扩展，针对业务场景深度定制。

适用场景

面向需要将业务流程封装为 AI Skill 的团队：现场实施、产品经理、研发工程师。

典型用例：

• 将 ERP/CRM/HIS 等系统的操作流程封装为 Skill
• 把重复性的数据查询、报表生成、单据处理自动化
• 快速适配不同客户的部署需求（参数调整模式）

四种模式

| 模式 | 触发场景 | 说明 | |------|---------|------| | 创建模式 | "帮我做一个新的 Skill" | 完整走需求深挖 → 接口收集 → Skill 生成 → 测试验证 | | 修改模式 | "帮我改一下这个 Skill" | 导入已有 Skill，差异对比确认后修改 | | 参数调整模式 | "换个客户部署" | 只改业务参数，不碰核心逻辑 | | 知识导入模式 | "先导入领域知识" | 从设计文档提取领域知识，后续复用 |

核心特性

需求深挖（Phase 1）

对每个业务步骤按三个维度递归追问，直到没有模糊地带：

| 维度 | 要回答的问题 | |------|-------------| | 数据来源 | 这个数据从哪来？（用户输入 / 接口 / 固定配置） | | 判断逻辑 | 怎么决定走哪条路？（固定规则 / 用户选择 / AI 推理） | | 异常处理 | 拿不到或有歧义怎么办？（默认值 / 报错 / 降级） |

领域知识积累（Phase 0）

首次接触新业务领域时，从设计文档自动提取业务对象、术语、模块关联，存入 references/domains/。同领域后续创建 Skill 直接复用。

接口封装（Phase 3-4）

所有外部接口封装为 scripts/ 下的 Python 脚本，统一处理认证、错误、JSON 输出，并支持 --mock 模式用于测试。

测试验证

支持两种环境：

• 有 subagent（Claude Code / Cowork）：并行评估 + 自动评分 + Benchmark + Eval Viewer
• 无 subagent（单会话环境）：顺序执行 + inline 评分 + 简化 Benchmark

迭代改进

结构化的改进方法论：

• 从反馈泛化，不过拟合
• 保持 Skill 精简，去掉不起作用的指令
• 解释 why 而非堆 MUST
• 从 transcript 中发现可复用脚本

Description 触发优化

自动化优化循环（scripts/run_loop.py）或手动调整，提升 Skill 的触发准确度。

文件结构

biz-skill-creator/              # GitHub 仓库根目录
├── README.md
├── LICENSE.txt                 # Apache 2.0
└── skills/
    └── biz-skill-creator/      # ← 安装时复制这个目录
        ├── SKILL.md            # 核心指令
        ├── _meta.json          # 元数据
├── agents/                     # Subagent 指令
│   ├── grader.md               #   评分
│   ├── comparator.md           #   盲评 A/B 对比
│   └── analyzer.md             #   溯因分析
├── assets/
│   └── eval_review.html        # 触发评估审核模板
├── eval-viewer/                # 测试结果可视化
│   ├── generate_review.py
│   └── viewer.html
├── references/                 # 参考文档
│   ├── schemas.md              #   JSON 格式规范
│   ├── testing-basics.md       #   基础测试方法
│   ├── testing-tools.md        #   环境适配测试
│   ├── testing-iteration.md    #   迭代改进方法论
│   ├── templates.md            #   格式模板
│   ├── workflows.md            #   工作流模式
│   ├── output-patterns.md      #   输出模式
│   └── progressive-disclosure-patterns.md
└── scripts/                    # 工具脚本
    ├── run_loop.py             #   Eval + Improve 自动循环
    ├── run_eval.py             #   触发评估
    ├── improve_description.py  #   Description 优化
    ├── aggregate_benchmark.py  #   Benchmark 聚合
    ├── generate_report.py      #   报告生成
    ├── quick_validate.py       #   Skill 校验
    ├── package_skill.py        #   打包为 .skill 文件
    └── utils.py                #   通用工具

安装

克隆仓库后，将 skills/biz-skill-creator/ 目录复制到你的 Skill 存放位置：

git clone https://github.com/GarrusHuang/biz-skill-creator.git /tmp/biz-skill-creator

# Claude Code
cp -r /tmp/biz-skill-creator/skills/biz-skill-creator ~/.claude/skills/biz-skill-creator

# 其他平台（放到对应的 Skills 目录）
cp -r /tmp/biz-skill-creator/skills/biz-skill-creator /path/to/your/skills/biz-skill-creator

快速开始

安装后，对 AI 助手说：

• "帮我做一个查询订单状态的 Skill"→ 进入创建模式
• "帮我改一下这个报表生成的 Skill"→ 进入修改模式
• "这个 Skill 换到新客户环境部署"→ 进入参数调整模式

致谢

基于 Anthropic skills 项目的 skill-creator 扩展开发，遵循 Apache 2.0 许可证。

License

Apache License 2.0