SuperAPI AI 工具集

bmad-architecture

智能体与模型

查看项目

更新于 10-15 17:27

技能介绍

用途:产出“架构主干”(architecture spine)——一份一致性契约,只固定那些使各独立构建单元不会分歧的不变量:设计范式、边界与依赖规则、状态如何被修改、共享数据由谁拥有,即未来构建者无法从合规代码中直接读出的持久性决策。结构性内容(技术栈、目录树、完整数据形状)仅作为种子信息。

主要能力:以教练方式(Coaching path,默认)或快速方式(Fast path)协作;从 SPEC.md、memlog、原始想法、既有代码库或既有主干中提炼决策;以 AD-n 形式记录决策(含 Binds/Prevents/Rule),未决项列入 Deferred;产出 ARCHITECTURE-SPINE.md,并可选产出面向人的交付物。

使用方式:写入通过共享脚本 memlog.py,例如 uv run {project-root}/_bmad/scripts/memlog.py init --workspace {doc_workspace} --field scope="…" --field purpose="…" --field altitude="…",以及 uv run {project-root}/_bmad/scripts/memlog.py append --workspace {doc_workspace} --type <decision|constraint|version|assumption|question|direction|event> --text "…"。定制与配置分别通过 resolve_customization.py 和 resolve_config.py 解析。无交互时按 references/headless.md 执行。

适用场景:新建、更新或验证系统架构主干;从既有代码库提炼约定;处理某个 epic 切片的架构约束;作为后续 bmad-spec、bmad-create-epics-and-stories 或 bmad-build 的输入。

限制:不做需求、UX、能力契约或 epic 拆分(应改用对应技能);主干只记录决策而非理由(理由存于 memlog);命名的技术须先在网上核验当前版本与适配性;输入过薄时建议先做 bmad-spec;不得编造以填补空白。