用途:生成一份整合式“技术栈技能”,记录项目所用库之间的集成方式。
主要能力:code-mode 分析依赖清单与真实源码中的共同导入模式;compose-mode 在尚无代码库时,从预生成的单项技能与架构文档综合。所有发现须可追溯到真实代码并附 file:line 引用;compose-mode 允许推断集成,但须标注 [inferred from shared domain]。
工作流:共 10 步——初始化与模式检测、检测清单、排序并确认库、并行提取、检测集成、编译技术栈、生成输出、校验、报告、工作流健康检查。单次运行、不支持恢复;中断后从第 1 步重新开始。运行状态存于 {run_dir}({project-root}/_bmad-output/.skf-run/ 下)。
使用方式:激活时从 {project-root}/_bmad/skf/config.yaml 加载配置,解析 headless_mode(--headless/-H 启用,--headless=false/--no-headless 禁用,否则读 preferences.yaml,默认 false)。运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析定制;失败时仅读 {skill-root}/customize.toml。随后执行 references/init.md。
限制:零幻觉,内容须可追溯;一次只加载一个步骤文件;不得写入非 SKF 生成的技能文件夹;HARD HALT 须带退出码、halt_reason 与阶段;警告统一写入 workflow_warnings[] 与 {run_dir}/warnings.jsonl。路径约定:references/ 与 assets/ 从技能根解析,knowledge/ 与 shared/ 从 SKF 模块根解析。其余细节暂未提供。