用途:当用户要求“更新某个技能”或“重新生成某个技能”时,对既有技能做外科式更新——仅在源代码发生变化时,重新提取受影响的导出内容,同时完整保留 [MANUAL] 标记的开发者内容,不做全量重建。
主要能力:基于 AST 的结构化分析与溯源驱动的变更检测;只重提取发生变化的导出,未变动内容一律不改动;每条重新生成的指令都必须能追溯到代码并附带 file:line 引用;更新 SKILL.md、provenance-map.json,并产出 evidence-report.md;带工作流健康检查。
使用方式:以 Ferris Surgeon 模式运行,输入 skill_name(必填)。工作流按固定顺序执行八步:初始化与加载(step-01,需确认门)→ 检测变更 → 重新提取 → 合并 → 校验 → 写入 → 报告 → 工作流健康检查;除 step-01 外均自动推进。启动时从 {project-root}/_bmad/skf/config.yaml 读取配置,解析 project_name、output_folder、user_name、communication_language、document_output_language、skills_output_folder、forge_data_folder、sidecar_path;{headless_mode} 在传入 --headless 或 -H,或 preferences.yaml 中 headless_mode: true 时为 true,默认 false。headless 模式下各确认门按默认动作自动通过并记录每次自动决策。
适用场景:代码变动后维护已有技能,需要保留人工撰写内容且要求可溯源、可审计的更新流程。
限制:不支持 stack 类型技能(metadata.json 中 skill_type 为 "stack"),需改用 skf-create-stack-skill 基于更新后的组成部分重新组合;对 stack 技能本工作流会直接退出并给出重定向提示。每一步须完整读取该步文件后再行动,必须严格按序执行,不得跳过、重排或优化;一次只加载一个步骤文件,不得预载后续步骤;禁止臆造,所有陈述必须有 AST 溯源。其他输入参数、安装方式与价格信息暂未提供。