用途:生成一份整合的项目技术栈技能文档,说明项目所用库之间如何连接与集成。
两种模式:code 模式分析依赖清单以及实际源码中的共同导入(co-import)模式;compose 模式在尚无代码库时,从预先生成的单个技能与架构文档中合成。code 模式下每条发现都必须可溯源到实际代码并附 file:line 引用;compose 模式允许推断集成关系,但须标注 [inferred from shared domain]。
角色定位:以 Ferris Architect 模式运行的依赖分析师与集成架构师,结合用户在项目知识与范围上的偏好开展工作。
工作流规则:零幻觉,提取内容须溯源源码;每步开始前完整阅读步骤文件;严格遵循步骤顺序,不得跳过、重排或优化;一次只加载一个步骤文件,不得预加载后续步骤;缺少子流程或工具时在主上下文完成;按 {communication_language} 沟通;{headless_mode} 为 true 时在确认关卡按默认动作自动推进并记录每次自动决策。工作流状态中维护唯一的 workflow_warnings[] 累积列表,条目形如 {step, severity, code, message, context},由 step-07 呈现在 evidence-report.md,step-08 可补充校验发现,step-09 §5 读取并渲染用户可见的 Warnings 部分。
十个阶段:1 初始化与模式检测(需确认)、2 检测清单(自动)、3 排序与确认库(需确认)、4 并行提取(自动)、5 检测集成(自动)、6 编译技术栈(需评审)、7 生成输出(自动)、8 校验(自动)、9 报告(自动)、10 工作流健康检查(自动)。
调用契约:输入 project_path(必需)、mode(code/compose,自动检测);step-03 为确认关卡 [C];输出 SKILL.md(stack)、context-snippet.md、metadata.json;headless 时所有关卡按默认动作自动解决。
激活时:从 {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=false 或 --no-headless 使其为 false);其次显式启用(--headless 或 -H 使其为 true);否则从 {sidecar_path}/preferences.yaml 读取;默认 false。随后完整读取并执行 ./steps-c/step-01-init.md 启动工作流。
限制:资料未提供具体安装命令、收费或价格信息;实际使用依赖 _bmad/skf 配置与步骤文件。