BA Generation v7

Evidence-Bound Business Architecture Engineering

把业务架构从“一次性生成内容”，升级为可追溯、可评审、可返工、可发布的工程系统。

BA Generation v7 是一套面向复杂业务架构项目的 Claude Skill。它以 TOGAF 业务架构思想为方法基础，把战略、价值流、业务场景、能力与流程组织成一条受证据、Schema、运行时门禁、独立评审和用户确认共同约束的生产链。

它不是“让模型写一份看起来像咨询报告的文档”。它控制模型在什么证据上工作、何时可以进入下一关、哪些内容必须独立复核、返工能改哪些路径，以及最终发布物如何从同一 JSON 事实源确定性生成。

为什么需要它

大模型可以快速生成结构化内容，但业务架构真正困难的部分从来不是排版，而是边界判断与跨阶段一致性：

• 价值流、能力、流程容易被机械地一一映射，形成语法正确、业务错误的镜像架构；
• 轻量模型容易用自洽说明替代证据，用漂亮措辞掩盖拓扑缺口；
• 多轮返工可能悄悄改动已锁定父级、旧审批或无关对象；
• 多 Agent 协作若没有 hash、状态机和评审收据，无法证明“谁基于哪个版本做了什么判断”；
• Markdown、Excel 和汇编视图若被分别生成，会迅速漂移为多个事实源。

BA Generation v7 的设计原则是：模型负责专业判断，Runtime 负责不变量；Reviewer 负责反例挑战，用户负责最终裁决。

系统架构

flowchart LR
    A[用户输入与证据] --> B[Stage 00–03<br/>范围·战略·价值流]
    B --> C[Stage 04A–04D<br/>场景·需求·能力收敛]
    C --> D[Stage 05 Parent Design<br/>冻结 L1/L2 与分解方法]
    D --> E[Stage 05A<br/>生成并校准 Final L3]
    E --> F[Stage 05B<br/>展开 L4·对象·服务·KPI·集成]
    F --> G[Stage 06<br/>确定性汇编与发布]

    R[Schema + Runtime Gates] -.约束.-> B
    R -.约束.-> C
    R -.约束.-> D
    R -.约束.-> E
    R -.约束.-> F
    V[Architect / Business Expert<br/>隔离评审] -.挑战.-> C
    V -.挑战.-> E
    V -.挑战.-> F
    U[用户确认点] -.锁定或修订.-> E
    U -.锁定或修订.-> F

首版案例图集（保留）

下列图片保留自第一版公开的脱敏研发案例，用于展示业务架构内容经下游呈现后的视觉形态。它们基于早期 v4.19 契约生成，不是 v7.19.0 的 Schema、Runtime 或验收基线，也不是本 Skill 内置的 PPT、泳道图或流程说明文件输出。

Skill 负责结构化业务架构及其确定性派生视图；图片由下游渲染器根据汇编视图制作并导出为 PNG。案例经过脱敏但不是不可逆匿名化，请勿把其中对象、数字或设计作为客户业务事实模板。

对应的英文图集见 examples/rd-case-en/，完整的数据边界与版本说明见 examples/README.md。

核心能力

v7.19.0 更新重点

本版是在跨模型回归和全量发布审计基础上的一致性版本：

• 修复 user_review 被误解为“必须先批准才能继续修订”的流程问题；用户可批准当前 hash，也可直接要求下一轮受控修订；
• 支持 Stage05 Parent Design、05A Skeleton 与 05B Architecture 的原子跨关口差量修订，同时保持 L1—L3 身份与拓扑硬边界；
• 将 L1、L2、L3 的流程定义与流程目的统一升级为 每项 120–200 个 Unicode 字符的 Schema + Runtime 硬门；
• 消除 Stage05 文档、工作包、Schema 与运行时之间原有的“120–200 字 / 仅非空 / 低于 80 字只告警”三方冲突；
• 统一当前版本抬头、迁移说明、只读兼容集合和发布清单；
• 新增发布目录白名单与 GitHub 仓库忽略边界，避免项目运行数据、评审缓存和本地分析材料被误提交。

完整迁移记录见 reference/v7_migration.md。

模型选择不是实现细节

Runtime 可以阻止格式错误、非法跨关卡修改、缺失引用和不完整评审，但它不能替代业务判断。Stage04D 的能力聚合、Stage05 Parent Design 的管理对象切分，以及 05A/05B 的反事实边界审查，都需要具备稳定长上下文理解和反例推理能力的模型。

建议在关键 Consultant 与 Reviewer 角色上使用高能力推理模型。轻量模型适合确定性整理或低风险分片，但更容易出现能力—流程镜像、形式化 PASS、泛化 rationale 和边界证据不足等问题。结构门禁是安全网，不是推理能力的替代品。

安装

前置条件：Claude Code / Claude 原生 Skill 环境、Python 3.10 或更高版本。运行时只使用 Python 标准库，不调用本机模型 CLI，不读取本机认证、配置或聊天日志。

下载仓库后，将发布目录复制到 Claude Skills：

cp -R ./ba-generation ~/.claude/skills/ba-generation-v7
python3 ~/.claude/skills/ba-generation-v7/scripts/quick_validate.py

看到 SKILL MANIFEST PASSED 且全部离线测试通过，即表示安装包结构、版本契约和核心回归门完整。

快速开始

在 Claude Code 中直接说明目标，例如：

使用 ba-generation-v7，为某业务领域设计目标业务架构。
交付范围为 full_ba；先完成 Stage00 范围确认，不要跳过用户确认点。

也可以先显式初始化项目：

python3 ~/.claude/skills/ba-generation-v7/scripts/ba_runtime.py init \
  ./my_ba_project \
  --name "示例业务架构" \
  --domain "示例业务领域" \
  --scope full_ba

随后以 stage-status 查看状态，并严格按运行时给出的 next action 推进。不要手工修改 project_state.json、artifact hash、review receipt 或 lock 文件。

交付范围

full_ba 默认形成：

• 业务战略理解；
• 价值状态模型、价值流、价值流阶段与活动；
• 业务场景、利益相关方诉求、原始能力与 L1–L3 能力架构；
• L1–L4 流程架构、业务对象、业务服务、KPI 与集成关系；
• 正式 JSON、同源 Markdown、查询 Excel、候选发布清单、质量报告和开放事项登记。

value_capability 在 Stage04 完成，不进入流程架构。

明确不在范围内

本 Skill 不生成详细流程说明文件，包括 BPMN/流程泳道图、岗位角色说明、逐活动操作说明、KCP 控制手册或独立 Metric 指标手册。Stage05 中的对象、KPI 和责任字段属于流程架构级契约，不等同于流程设计或 SOP。

当前 Process 5.3.0 仍要求每个 L2 至少包含一个 L3，且每个 L3 至少包含两个 L4。允许 L3 直接成为叶节点是后续独立契约升级项，不在本版内隐式放宽。

仓库结构

ba-generation/
├── SKILL.md                 # 渐进加载入口与总控协议
├── agents/                  # Consultant / Reviewer 角色契约
├── stages/                  # Stage 00–06 执行说明
├── methodology/             # 唯一方法规则源
├── schemas/                 # JSON Schema 公共契约
├── scripts/                 # 状态机、门禁、评审、计量与汇编
├── checklists/              # Gate 级检查项
├── reference/               # 协议、迁移、命令与交接记录
├── examples/                # 结构示例，不作为业务事实模板
└── tests/                   # 离线回归测试

运行目录 workspace/、metrics/、tmp_build/、缓存和客户项目数据不属于发布包。

质量验证

cd ba-generation
python3 scripts/quick_validate.py

当前发布基线包含 171 项离线回归，覆盖版本一致性、状态迁移、Stage04/05 语义门、评审索引、差量返工、锁与 hash、计量、确定性 Excel/Markdown 汇编及历史只读兼容。

设计边界与声明

• 本项目借鉴 TOGAF 业务架构概念，但不是 The Open Group 的官方实现或认证产品。
• 示例只用于解释契约形状，不得复制为客户业务事实。
• 旧版锁定成果按声明版本只读兼容；进入当前活动链前必须使用正式升级命令，不允许原地伪造升级。
• 最终业务架构仍需由具备授权的业务负责人和架构负责人确认。

Architecture that can explain itself, defend itself, and survive revision.