Skill builder

Skill Builder

把用户提供的经验、方法、流程、需求或材料整理为一项具体任务。先判断信息是否足以生成，再输出经验蒸馏报告和可安装 Skill ZIP。

不要把生成过程扩展为审批、发布或 Workflow 编排。

工作流程

1. 建立任务草图

从当前对话和用户材料中提取：

• 任务目标；
• 触发场景；
• 使用者；
• 必要输入和前置条件；
• 核心步骤与判断；
• 工具和运行条件；
• 预期输出与最低质量要求；
• 异常、边界和真实案例。

先用四行以内复述当前理解，不直接生成文件包：

本次要整理的任务：
它解决的问题：
主要使用者：
最终产出：

材料中没有的信息保持为空，不自行补成业务事实。

2. 判定类型和完整度

读取类型判定规则，确定一个主类型和必要的配套类型。按任务稳定执行最依赖的机制判断，不按材料来源、岗位数量或输出文件名称判断。

读取引导式访谈问题库，检查通用必须项和主类型相关信息。将当前状态标记为：

• insufficient：不足以生成；
• v0.1：可以生成初版，但仍有明确缺口；
• stable：关键业务规则不需要 AI 猜测。

任务包含会改变执行结果的条件、范围、分支、例外、权限或停止规则时，读取语义完整性检查。只对高影响歧义建立当前生成过程使用的临时语义检查草图；无歧义任务不增加问题或新交付物。

3. 只追问最大缺口

信息不足时，每轮优先问 1 至 2 个问题，最多 3 个。先问会阻止任务成立的问题，再问主类型中会改变执行结果的问题。已经确认的内容不要重复询问。

用户无法继续补充时，若任务边界已经成立，允许生成 v0.1；若任务目标、触发场景或预期输出仍不清楚，只返回任务草图和缺口，不生成空壳 Skill。

4. 确认生成摘要

达到 v0.1 或 stable 后，展示：

任务：
主要使用者：
主类型：
配套类型：
固定文件：
按需文件：
仍待补充或验证的内容：

等待用户确认后生成。用户已经明确要求按当前信息直接生成时，可以跳过重复确认，但仍要标注缺口和假设。

5. 创建 SkillSpec

读取生成与文件路由规则、生成质量标准和边界与失败处理。

创建临时 skill-spec.json，并将信息分开写入：

• confirmed：用户明确说明或材料直接记载的事实；
• inferred：AI 根据材料归纳、但用户尚未确认的内容；
• missing：执行需要但当前没有的信息；
• hypotheses：需要通过案例或运行验证的判断。

生成内容前，按语义完整性检查结果处理关键规则：可以确认的歧义进入现有追问额度；非核心缺口只有在目标 Skill 能明确停止或转人工时才允许降为 v0.1；影响主要执行路径、安全、权限、不可逆操作或最终责任的歧义不得靠降版本绕过。

使用活动复盘 SkillSpec作为字段结构示例。不要照抄其中的业务内容。

生成目标 Skill 正文时：

• 用祈使句写清执行动作、判断和停止条件；
• 只生成任务需要的配套文件；
• 没有真实材料时不虚构案例、阈值、权限、依赖或公司规则；
• 每份 references/ 文件都由目标 SKILL.md 直接链接；
• 不把临时 SkillSpec 放入最终文件包。

内容生成后，对经验蒸馏报告、目标 SKILL.md、references 和模板执行来源一致性、规则完整性与跨文件一致性检查。检查只发现问题，不替用户修改业务含义。

6. 生成并校验文件包

把临时 SkillSpec 保存到系统临时目录，或用户指定的中间目录。输出目录优先使用用户指定路径；未指定时使用当前工作目录下的 outputs/。

运行组包脚本：

python scripts/build_package.py --spec <skill-spec.json> --output <output-directory>

按语义检查结果完成追问、缺口标注或阻断处理，并满足对应完整度门槛后再运行脚本。脚本会生成报告、Skill 目录和 ZIP，并自动执行包结构校验。需要单独复查目录时，运行校验脚本：

python scripts/validate_package.py <skill-directory> --zip <skill.zip>

组包阶段不得运行目标 Skill 中新生成的脚本。校验失败时返回具体错误，不返回未通过校验的 ZIP。

7. 返回结果

向用户说明：

• 经验蒸馏报告路径；
• Skill ZIP 路径；
• Skill 名称和版本；
• 当前完整度；
• 仍待补充或验证的内容。

不要把内部 SkillSpec 当作第三类交付物。

运行约束

• 不读取或写入用户未指定的无关目录。
• 不收集、保存或输出真实密钥。
• 不自动保存后续员工材料到 cases/。
• 不自动安装、审核或发布生成的 Skill。
• 不实现多 Agent 调度、岗位 Agent 配置或 Workflow 编排。
• 用户材料冲突、安全边界不清或要求越权执行时，按边界与失败处理停止或降级。