尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
BMAD-METHOD 既有项目 FAQ 详解:何时运行 document-project、bmad-build 如何落地既有代码库
BMAD-METHOD 既有项目 FAQ 详解何时运行 document-project、bmad-build 如何落地既有代码库【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD本文基于 BMAD-METHOD 仓库法语文档站的《FAQ Projets Existants》既有项目常见问题展开完整覆盖该 FAQ 的四个核心问题是否需要先运行document-project、忘记运行时如何补救、bmad-build在既有项目中的实现机制以及既有代码不符合最佳实践时的决策方式。读完后你将掌握在遗留代码库上安全接入 BMAD 工作流的判断框架、bmad-build的入口参数与规格质量标准并能对照当前仓库源码确认各 FAQ 结论的实际实现依据。一、问题 1是否应该先运行document-project原文档给出的答案是强烈建议先运行尤其是在以下三种情况下项目没有任何现有文档现有文档已经过时AI Agent需要关于既有代码的上下文才能开展工作。在两种情况下可以跳过该步骤你已经拥有完整且最新的项目文档原文以包含docs/index.md为例——这里的docs/index.md指的是你的目标项目中的索引文档你会使用其他工具或技术辅助代码发现让 Agent 能够直接在既有系统之上构建。配套指南中的定位在同语言目录的操作指南 既有项目指南 中文档质量被列为既有项目四步流程的第三步docs/目录应包含简洁、组织良好且忠实反映项目的文档涵盖业务意图与规则、架构等关键信息对复杂项目指南明确建议考虑bmad-document-project工作流因为它提供会扫描整个项目并记录系统真实当前状态的执行变体。需要注意当前仓库的术语状态从仓库结构看skills/目录下已不存在独立的bmad-document-project技能而 技能移除清单 中记录了相关演进——bmad-bmm-document-project是 v6.2.0 之前带模块前缀的旧包装技能已清理技术写作 AgentPaige虽已退役但清单注释明确写道“document-project remains directly invocabledocument-project 仍可直接调用”。此外既有代码库入门文档 指出“earlierbmad-document-projectworkflow is deprecated”早期的bmad-document-project工作流已弃用。这可以推断FAQ 中“先运行document-project建立文档基线”的方法论依然成立但其具体载体正在向 bmad-project-context 技能 收敛——该技能不再生成大而全的文档树而是在目标仓库的AGENTS.md中写入一小段经过路径校验与命令验证的受管代码块且 韩文版既有项目 FAQ 明确说明bmad-document-project已由bmad-project-context取代。对读者的实际含义是FAQ 强调的是“让 Agent 先获得经过验证的项目上下文”而不是死守某一个旧命令名。二、问题 2忘记运行document-project怎么办FAQ 的回答很直接不必担心——你可以随时补做甚至在项目进行到一半或完成之后运行以持续保持文档上下文与代码同步。这一点在当前仓库的 bmad-project-context 技能 源码中得到了印证该技能定义了五种意图setup | adopt | refresh | record | audit其中refresh以差异方式重跑重新校验每一行中的路径与限定说明并用git log --diff-filterDR --name-only对比上次记录的 SHA 检查被删除/重命名的文件证据消失的行会被更新或移除——“事后补救并保持一致”被设计为一等公民能力audit复查每一条告诫、逐条路径校验、追问“删掉这一行是否会改变 Agent 行为”审计结束后代码块只会变小或保持不变record在 Agent 犯错的那一刻记录一条 pitfall作为上下文块的补充证据。也就是说“文档基线可以晚建立、但可以持续刷新”在实现层面是有明确流程支撑的而不是口头安慰。三、问题 3既有项目中的实现Implementation是如何工作的FAQ 的核心结论在既有项目上运行bmad-build与全新开发完全相同。工作流会依次完成四件事自动检测你现有的技术栈Detected automatically分析既有代码模式检测约定并请求确认Checkpoint等待人工拍板生成一份上下文丰富、且尊重既有代码的技术规格说明。进入方式有两种视工作规模而定修改清晰、范围小直接把请求、Issue 或既有规格丢进bmad-build工作量大提供一条已规划的 story 及其上游制品PRD、架构、epics 等让 build 在完整上下文上施工。源码佐证bmad-build 的真实结构查看 skills/bmad-build/SKILL.md 可以看到bmad-build技能本身是一个薄启动器它只要求执行一次uv run .../render_skill.py --project-root ... --skill ...把技能目录渲染为真正的工作流文件然后读取并遵循 stdout 打印出的workflow.md指令。该启动器还暴露了两个关键参数与 FAQ 中“按规模进入”的建议一一对应--set workflow.routeoneshot|fulloneshot对应直接带清晰修改请求进来full对应携带完整上游制品的更大工作--set workflow.reviewnone|quick|thorough控制产出代码后的评审深度。渲染后的 skills/bmad-build/workflow.md 展示了 FAQ 四个步骤背后的执行纪律Step-file 架构每个步骤是自包含的微文件按step-01-clarify-and-route顺序加载明确规定“WAIT FOR INPUT: Halt at checkpoints and wait for human”——这正是 FAQ 所说“检测约定并请求确认”的实现机制工作流在检查点处强制停住等待人工输入READY FOR DEVELOPMENT STANDARD规格必须满足 Actionable每个任务有文件路径与具体动作、Logical按依赖排序、TestableAC 采用 Given/When/Then、Complete无占位符、Sufficient无未解决的需求/验收/依赖缺口、Coherent无歧义与内部矛盾。这解释了 FAQ 中“生成尊重既有代码的富上下文规格”的含义——规格的每个任务都锚定到既有代码库的具体文件路径与既有约定SCOPE STANDARD一份规格应聚焦单一用户可见目标体量建议 900–1600 tokens低于 900 有歧义风险高于 1600 会让实现 Agent 出现上下文腐化且“单一目标”的判据是不计表面动词只看是否产生两个以上可独立评审、测试、合并的顶层交付物——这为“清晰修改直接进、大改动带上游制品再进”提供了量化依据。四、问题 4既有代码不符合最佳实践怎么办FAQ 描述了完整的决策协议bmad-build会检测你既有的约定并主动询问“Dois-je suivre ces conventions existantes ?”我该遵循这些既有约定吗由你决定是Oui→ 保持与当前代码库的一致性否Non→ 确立新规范并且必须在技术规格中记录这样做的理由方法论原则BMM 尊重你的选择——它不会强制推行现代化只会提出建议it will not force modernization, but will propose it。结合 workflow.md 的 Step Processing Rules 可以看到该协议为何可信工作流被要求“NEVER skip steps or optimize the sequence”并“ALWAYS halt at checkpoints and wait for human input”。约定冲突因此不会由 Agent 静默吞掉而是被固定成一个显式的人工决策点若你选择“确立新规范”规格中记录理由的要求又与 READY FOR DEVELOPMENT 标准中的 Coherent无内部矛盾相呼应——新旧约定混用而缺少理由会直接使规格不达标。五、配套流程既有项目接入 BMAD 的完整路径为了把 FAQ 的四个答案放回实操场景以下是同目录操作指南 docs/fr/how-to/established-projects.md 的完整流程前提已通过npx bmad-method install安装 BMad并拥有 AI IDE 访问权限清理已完成的规划制品若 PRD 的所有 epics/stories 已全部完成归档或删除这些文件不要残留在docs/、_bmad-output/planning-artifacts/、_bmad-output/implementation-artifacts/中创建项目上下文生成项目上下文文件以捕获既有代码库的模式与约定确保 Agent 实现修改时遵循已确立的实践指南建议审查并精修生成结果或手工维护该文件维持高质量的项目文档docs/应包含业务意图、业务规则、架构等忠实内容复杂项目使用bmad-document-project类工作流扫描并记录系统真实状态参见第一节关于该命令当前形态的说明善用bmad-help每当不确定下一步时运行它——它会检查项目已做了什么、按已安装模块给出选项、理解自然语言请求并在每个工作流结束时自动运行给出后续建议。指南还给出了规划深度选择表与 FAQ 的“直接进 / 带上游制品进”相互印证范围推荐做法清晰的更新或新增直接带请求、Issue 或既有规格进入bmad-build重大修改或新增先准备 PRD、UX、架构、epics、stories 及 sprint 上下文再把选定的工作交给bmad-build两个前置提醒同样值得记住创建 PRD 时要确保 Agent找到并分析了你的既有项目文档创建架构时要确保架构师分析了既有代码库避免重新发明轮子或与现有架构脱节。UX 工作则是可选的——决策依据不是“项目有没有 UI”而是“这次改动是否涉及 UX 修改或需要新的 UX 设计/模式”。六、延伸阅读与佐证路径法语版既有项目 FAQ本文主体文档四个问题的原始完整答案法语版既有项目操作指南四步接入流程与规划深度决策表bmad-build 技能启动器 与 bmad-build 工作流route/review参数、检查点纪律、Ready-for-Development 与 Scope 标准bmad-project-context 技能setup/adopt/refresh/record/audit五种意图与“先展示代码块、用户批准后写入、绝不自动提交”的约束技能移除清单bmad-document-project、bmad-check-implementation-readiness已并入 bmad-sprint-planning等历史命令的演进记录既有代码库入门 与 项目上下文理论从“生成大文档树”到“为 Agent 维护小而受验证的上下文”的方法论变化韩文版既有项目 FAQ关于bmad-project-context取代旧命令的最新表述。FAQ 原文结尾邀请如果这里没有回答你的问题请通过仓库的 Issue 或官方社区渠道提问以便把答案补充进文档。小结FAQ 问题结论仓库佐证先运行document-project吗强烈建议无文档/文档过时/Agent 缺上下文时文档完备或有其他发现手段时可跳过操作指南、removals.txt 中的演进记录忘记运行怎么办随时可补做项目中/后均可bmad-project-context 的 refresh/audit 意图既有项目如何实现bmad-build与全新开发相同检测技术栈 → 分析模式 → 约定确认 → 生成尊重既有代码的规格SKILL.md 的 route/review 参数、workflow.md 的检查点与规格标准既有代码不合最佳实践Agent 检测约定并询问由人决定跟随或立新规理由写入规格BMM 只建议、不强制workflow.md 的 halt-at-checkpoint 规则【免费下载链接】BMAD-METHODBreakthrough Method for Agile Ai Driven Development项目地址: https://gitcode.com/gh_mirrors/bm/BMAD-METHOD创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED

相关推荐

自动驾驶决策规划中的行为树动态剪枝优化实践

自动驾驶决策规划中的行为树动态剪枝优化实践

1. 项目背景与核心价值自动驾驶决策规划系统是车辆智能化的核心大脑,而Apollo作为行业领先的开源平台,其行为树架构的决策逻辑直接影响着行车安全与效率。在实际道路测试中我们发现,传统静态行为树存在计算冗余问题——即便环境状态明确时&am…

📅 2026/9/18 7:19:37
k-skill 实战:用 korean-character-count 技能对韩文文本做确定性字数/行数/字节数统计

k-skill 实战:用 korean-character-count 技能对韩文文本做确定性字数/行数/字节数统计

k-skill 实战:用 korean-character-count 技能对韩文文本做确定性字数/行数/字节数统计 【免费下载链接】k-skill 한국인을 위한 스킬 모음집 - 에이전트를 한국인으로 项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill 本文以 k-skill 仓库中 kor…

📅 2026/9/18 7:19:37
Flask 命令行接口(CLI)完全指南:应用发现、开发服务器、dotenv 与自定义命令实战

Flask 命令行接口(CLI)完全指南:应用发现、开发服务器、dotenv 与自定义命令实战

Flask 命令行接口(CLI)完全指南:应用发现、开发服务器、dotenv 与自定义命令实战 【免费下载链接】flask The Python micro framework for building web applications. 项目地址: https://gitcode.com/gh_mirrors/fl/flask 本文以 Fla…

📅 2026/9/18 7:19:37
MORE NEWS

更多资讯

📰

从SLAM到空间智能:英特尔谈室内机器人核心技术

前阵子英特尔技术团队做了一场主题为“空间智能:室内机器人SLAM技术展望”的线上分享,我看完之后第一反应是:这大概是近两年讲SLAM讲得最系统的一次公开内容。很多人一提SLAM就想到扫地机器人绕圈、想到激光雷达转个不停,但英特尔…

📰

pdf.js 内置 Brotli 解码器解析:external/brotli 模块、release-brotli 构建任务与 /BrotliDecode 解码链路

pdf.js 内置 Brotli 解码器解析:external/brotli 模块、release-brotli 构建任务与 /BrotliDecode 解码链路 【免费下载链接】pdf.js PDF Reader in JavaScript 项目地址: https://gitcode.com/gh_mirrors/pd/pdf.js 导读 本篇文章围绕 pdf.js 仓库中 exter…

📰

10kV供配电设计全流程:从负荷计算到保护整定

简介:工厂10kV供配电设计课程设计完整文档,面向电气工程、自动化等专业本科生及供配电设计入门者,系统梳理10kV工厂供配电设计全流程。压缩包内仅1个doc文件,容量814KB,内容涵盖设计内容与要求、负荷计算与无功补偿、变…

📰

STM32频率测量实战:输入捕获与FFT选型、代码与避坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📰

Tempo 项目中的 Participle:用 Go 结构体标签构建死简单解析器的完整实战指南

Tempo 项目中的 Participle:用 Go 结构体标签构建死简单解析器的完整实战指南 【免费下载链接】tempo Grafana Tempo is a high volume, minimal dependency distributed tracing backend. 项目地址: https://gitcode.com/GitHub_Trending/tempo1/tempo part…

📰

PyQt5企业级开发:架构设计与性能优化实战

1. PyQt项目开发全景解析作为Python生态中最成熟的GUI框架之一,PyQt在企业级应用开发中占据重要地位。最近在重构一个遗留的PyQt5项目时,我系统梳理了从环境搭建到部署上线的完整构造流程。与常见的教程不同,本文将重点分享实际工程中那些容易…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬