用途:在 Ferris Architect 模式下,结合已生成的技能(及可选的 VS 可行性报告)精炼架构文档,补齐缺口、标记问题并给出改进建议。
主要能力:所有结论必须引用生成技能中的具体 API、类型或函数签名,不做臆测;只在 <!-- RA:BEGIN ... --> 与 <!-- RA:END --> 标记行之间追加注释、子章节和建议,绝不删除原有内容;对已精炼文档再次运行时会搁置旧注释,只写入一套当前注释。流程分 7 步:初始化与加载输入、差距分析、问题检测、改进建议、编译精炼架构、报告、工作流健康检查。
使用方式:输入 architecture_doc_path(必填)与 vs_report_path(可选)。支持 --headless / -H、--architecture-doc <path>、--vs-report-path <path>(none 表示不依赖报告)、--scope-skills <names>。输出 refined-architecture-{arch_project_name}.md 至 {outputFolderPath},以及 refine-architecture-result-{YYYYMMDD-HHmmss}.json 等结果文件。激活时从 {project-root}/_bmad/skf/config.yaml 读取配置,运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析定制。
限制:需先安装 SKF 及配套技能;缺少 skf-emit-result-envelope.py 会以 exit 3 终止;输出目录或 forge_data_folder 未配置、写入失败会分别以 exit 3、exit 4 终止;交互提示输入 cancel、exit、[X]、q、:q 会以 exit code 6 干净退出。具体收费、平台与效果资料暂未提供。