用途：分析大型仓库或多服务项目，识别离散的、可技能化的单元，映射其导出与集成点，产出推荐的 skill-brief.yaml 文件，作为存量项目接入技能体系的主要入口。分析需足够深入以产出可执行的 brief，同时控制范围避免误报过多。导出信息来自各 forge 层级的 ast-grep recipe runner（缺少 ast-grep 或该语言无 recipe 时人工阅读）。
主要能力：按阶段推进工作流——初始化、自动定范围（[auto] 模式）、会话续跑、扫描项目、识别单元、映射与检测、推荐、生成 brief、工作流健康检查。支持交互模式与无头模式（--headless / -H 将确认门转为自动通过），[auto] 括号修饰符激活自动定范围模式。
使用方式：输入 project_path（必填，仓库 URL 或本地路径，[auto] 模式下可为文档 URL），可选 intent_hint、scope_hint、target_ref 或 target_refs。无头参数包括 --project-path、--scope-hint、--intent-hint、--target-ref、--target-refs、--pin。激活时解析 envelope helper，加载 {project-root}/_bmad/skf/config.yaml，解析 headless_mode，运行定制解析脚本，创建运行目录。
输出：analysis-report.md、每个推荐单元一个 skill-brief.yaml 及运行结果文件；无头模式在 stdout 输出最终 SKF_ANALYZE_RESULT_JSON 行。
限制：需先完成 SKF setup 并存在 config.yaml，否则硬停止；缺少 skf-emit-result-envelope.py 时硬停止并提示重装 SKF；运行目录无法创建时硬停止。具体收费、价格、平台支持等资料暂未提供。