用途:检测技能与其当前源代码之间的漂移,输出带严重程度分级的漂移报告,包含基于 AST 的发现与修复建议。分析深度跟随 forge 层级(Quick/Forge/Forge+/Deep)。
主要能力:组合模式(compose-mode)栈通过元数据哈希检查其组成项的新鲜度;代码模式(code-mode)栈按库逐一 diff;纯文档技能按其文档哈希审计;无溯源映射(provenance map)的技能没有基线,第 1 步即停止。工作流分阶段:初始化与基线、上游检出(仅当上游变动)、组成项新鲜度、重新索引源码、结构 diff、语义 diff、严重程度分类、文档漂移、报告、工作流健康检查。
使用方式:输入 skill_name(必填)、skill_path(可选)、tier_override(可选)、upstream_drift_choice(可选 C/S/X)。激活时从 {project-root}/_bmad/skf/config.yaml 加载配置,解析 headless_mode(--headless 或 -H,或 preferences.yaml 中 headless_mode: true),并运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析自定义配置。预检需 uv 及 skf-emit-result-envelope.py、skf-load-provenance.py、skf-structural-diff.py、skf-severity-classify.py、skf-detect-docs.py 等辅助脚本,缺失则 HALT(exit code 3,halt_reason: "helper-missing")。创建运行目录:mkdir -p "{project-root}/_bmad-output/.skf-run" && mkdir "{run_dir}"。
限制:所有发现必须追溯到源代码,不得编造;一次只加载一个步骤文件;输出位于 {forge_version}/ 目录;运行状态存于 {run_dir},第 6 步删除,HALT 则保留。具体收费、平台支持等信息暂未提供。