SuperAPI AI 工具集

bmad-walkthrough

测试与质量

查看项目

更新于 10-15 17:27

技能介绍

用途:引导人类审查一次变更,从目的与上下文逐步进入细节。角色定位是协助用户完成变更评审。

主要能力:作为 Walkthrough Workflow 运行;激活时解析工作流配置块、执行前置步骤、加载持久事实、读取配置、向用户问候,再执行追加步骤。路径约定方面,裸路径(如 step-01-orientation.md)从技能根目录解析;{skill-root} 指向该技能安装目录(customize.toml 所在处);{project-root} 前缀路径从项目工作目录解析;{skill-name} 解析为技能目录的 basename。全局步骤规则要求:代码引用一律使用相对当前工作目录的 path:line 格式(不带前导斜杠),便于在 IDE 终端中点击跳转;每步输出应一次性完整给出,不在步骤中途提问或分批推送。

使用方式:激活流程先运行 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow 解析工作流块;若脚本失败,则按 base → team → user 顺序读取 {skill-root}/customize.toml、{project-root}/_bmad/custom/{skill-name}.toml、{project-root}/_bmad/custom/{skill-name}.user.toml 并应用相同的结构合并规则(缺失文件跳过;标量覆盖、表深合并、按 code 或 id 键控的表数组替换匹配项并追加新项、其他数组追加)。随后依次执行 {workflow.activation_steps_prepend},加载 {workflow.persistent_facts}(file: 前缀条目按项目根下路径或 glob 加载为事实,其余按原文作为事实),运行 uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.bmm.implementation_artifacts --key modules.bmm.planning_artifacts 读取配置,问候用户,再执行 {workflow.activation_steps_append}。全部激活步骤完成后方可开始主工作流,第一步是完整阅读并遵循 steps/step-01-orientation.md。

适用场景:用户需要被引导审查一次变更、理解变更用途、明确重点查看内容以及如何测试时。

限制:资料未提供具体收费、价格、平台支持与效果说明;仅覆盖上述激活与步骤流程,具体步骤内容需以各 steps 文件为准。