用途:skf-brief-skill 用于在创建智能体技能前界定“要做什么技能”,产出 skill-brief.yaml,作为后续 create-skill 编译步骤的输入契约。它强调紧凑、内聚的边界:一个能力、3-8 个主要函数、明确的公共 API 面,以及短到能放进注册表一行的描述;范围过大比过小更糟,范围不清时倾向更小更锐利的版本。
主要能力:引导式发现目标仓库、范围、语言与包含/排除模式;基于清单、顶层导出、意图等低成本信号界定范围,而非完整 AST 提取;支持“批准路径”,即对已有 skill-brief.yaml(通常来自 skf-analyze-source)进行审阅并写入 {forge_data_folder}/{name}/skill-brief.yaml,交互式在首个提示传入路径,无头模式传 from_brief <path>。
使用方式:流程从 gather-intent.md 开始,按模式路由。交互式依次经过 Gather Intent、Analyze Target、Scope Definition、Confirm Brief、Write Brief、Workflow Health Check;无头模式先经 headless-args.md 校验参数再进入阶段 2;auto 模式走 step-auto-brief.md → step-auto-validate.md → health-check.md;批准路径直接跳到阶段 4。激活时从 {project-root}/_bmad/skf/config.yaml 加载配置,解析 headless_mode、auto_mode 与工作流定制,并运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow。
限制:资料未提供收费、价格、平台与效果信息;无头或 auto 模式下 HALT 会通过 skf-emit-brief-result-envelope.py 输出 SKF_BRIEF_RESULT_JSON 错误信封,交互式非 auto 模式仅显示停止消息;若定制解析器不可用,则仅读取内置 customize.toml 并记录警告。