Business skill factory

Business Skill Factory

把一个调研结果、SOP、工作流、方法论或工具流程沉淀成通用可复用 skill。

核心流程：

调研 → skill spec → 生成 skill 文件夹 → 生成测试集 → 自评/校验 → 打包交付

硬规则

• 先收集最小规格字段，再生成 skill。
• 生成物必须通用可移植；不要默认写入个人路径、个人姓名、私有账号或本地 channel。
• SKILL.md 保持精简；详细流程、模板、规则放入 references。
• 必须生成 test-prompts.json，至少包含 happy path、信息不足、风险边界 3 类测试。
• 测试用例必须包含 expected_mode、expected、must_not_include、quality_checks，不能只写泛泛期望。
• 必须有信息不足降级规则，不能硬凑最终 skill。
• 必须做安全检查：不写 token、cookie、OAuth、账号密钥、客户隐私。
• 不自动安装或覆盖已有 skill；安装/覆盖前必须让用户确认。

默认输出模式

用户意图	模式	动作
“我想做一个 skill”但信息很少	draft	补问最多 5 个关键问题
已有明确流程/SOP	scaffold	生成 skill 文件夹和测试集
有流程、样例、边界、输出标准	production	生成完整 skill + scorecard + tar.gz
改已有 skill	update	读现有 skill，输出 diff/补丁/重评分

工作流

1. 调研

读取 references/intake-questionnaire.md。

最小必填：

• skill_name / 名称方向
• 目标用户
• 核心任务
• 触发词/典型用户说法
• 输入材料
• 输出物
• 标准流程
• 边界/不能做
• 信息不足降级
• 测试场景至少 3 个

缺字段时只补问，不生成最终 skill。

2. 规格书

按 references/skill-spec-schema.md 生成：

• skill-spec.json
• skill-spec.md（可读版）

3. 选择模板

按 references/domain-templates.md 判断类型：

• SOP / Workflow
• Content / Marketing
• Tool / API
• Analysis / Research
• Document / Report
• Internal Knowledge

4. 生成 skill

按 references/generation-rules.md 生成目录：

<skill-name>/
├── SKILL.md
├── references/
├── assets/          # 可选
├── scripts/         # 可选
├── test-prompts.json
└── scorecard.md

可用脚本：

python3 scripts/generate_business_skill.py <skill-spec.json> --output <dir>
python3 scripts/validate_business_skill.py <skill-dir>
python3 scripts/score_business_skill.py <skill-dir>
python3 scripts/review_test_prompts.py <skill-dir>
python3 scripts/package_business_skill.py <skill-dir> --dist <dist-dir>

生成时必须按 references/domain-templates.md 选择类型：

• SOP / Workflow：生成 workflow、降级、模板、质量规则、案例。
• Content / Marketing：额外生成 platform-rules、content-quality-rules、compliance-rules。
• Tool / API：额外生成 scripts、安全认证说明、错误处理和 dry-run runner。
• Analysis / Research：额外生成 research-workflow、source-quality、evidence 规则。
• Document / Report：额外生成 report-structure、style-guide。
• Internal Knowledge：额外生成 source-of-truth、维护和隐私边界。

5. 测试与评分

读取：

• references/pass-fail-testing.md
• references/darwin-checklist.md
• references/scorecard-template.md

评分口径：

• <80：不合格
• 80–86：草稿可用
• 87–90：正式可用
• 90+：精品

评分不能只看文件是否存在；必须检查生成物是否还有 待补充、测试是否可机械判定、Tool/API 是否有安全认证和错误处理说明、scorecard 是否列出待跑测试。

6. 安全检查与打包

读取 references/security-review.md。

通过校验后打包 tar.gz。

References

• references/open-source-design.md：通用开源设计原则
• references/intake-questionnaire.md：调研问卷
• references/skill-spec-schema.md：规格字段
• references/domain-templates.md：领域模板
• references/generation-rules.md：生成规则
• references/pass-fail-testing.md：测试规则
• references/darwin-checklist.md：评分清单
• references/security-review.md：安全检查
• references/scorecard-template.md：评分报告模板
• references/examples.md：示例

输出格式

已生成 Skill：<skill-name>
模式：draft/scaffold/production/update
路径：...
包：...
自评分：.../100
状态：不合格/草稿/正式可用/精品
下一步：...