核心功能
kai-business-blueprint 是一款企业级业务架构建模技能,专注于将非结构化需求文档转化为标准化的业务能力蓝图(Business Capability Blueprint)。核心工作流包括:
1. 实体提取:AI 代理从源材料中提取业务能力(capabilities)、参与者(actors)、流程步骤(flowSteps)和支撑系统(systems)
2. 蓝图生成:输出符合 JSON Schema 的结构化蓝图文件,包含完整的元数据、上下文、实体库和关系定义
3. 可视化导出:支持 SVG(默认)、draw.io、Excalidraw、Mermaid 等多种格式,并内置 HTML 交互式查看器
4. 下游投影:生成 solution.projection.json 供报告生成、幻灯片制作等下游技能消费
显著优点
- 行业适配:内置
common、finance、manufacturing、retail四大行业模板,提供领域特定的提取提示(hints) - 架构图专业化:支持 Serverless、微服务/Kubernetes 等标准架构模板,遵循深色模式设计系统,自动生成符合 L→R 数据流规范的架构图
- 完整性校验:内置
--validate命令,支持结构诊断与降级回退策略(freeflow → 失败退出) - 沙箱友好:针对 Jupyter/云端 REPL 环境优化,避免
__file__等沙箱不兼容模式
局限与风险
- Python 版本限制:要求 Python ≥3.12,低版本拒绝安装
- 平台覆盖:Phase 2 未实现 Windows PowerShell 完整兼容,编码问题需显式设置
PYTHONIOENCODING=utf-8 - 模板边界:非标准架构请求强制降级到
freeflow,可能丢失特定视觉语义 - 几何完整性:复杂布局可能触发完整性检查失败,需人工介入或接受降级输出
适用人群
企业架构师、解决方案顾问、售前工程师、产品经理,以及需要将业务需求快速转化为可交付架构文档的跨职能团队。
常规风险提示
- 下游技能禁止直接编辑
solution.blueprint.json,应通过投影文件消费 solution.handoff.json仅作查看元数据,非叙事输入- 架构图生成需确保
references/architecture-design-system.md及模板文件可访问