核心用法
kai-business-blueprint 是一款面向企业级解决方案设计的结构化建模技能，核心功能是将非结构化的售前材料（会议记录、方案文档、需求说明）转化为标准化的商业能力蓝图（Business Capability Blueprint）与领域知识地图。
使用流程遵循五步闭环：
1. 行业选择 — 从 common（通用）、finance（金融）、manufacturing（制造）、retail（零售）四选一，加载对应种子模板
2. 实体提取 — 自动识别 capabilities（能力）、actors（参与者）、flowSteps（流程步骤）、systems（系统）或知识实体（library.knowledge.*）
3. 蓝图生成 — 输出符合 schema 规范的 JSON 文件至 projects/workspace/
4. 可视化导出 — 默认 SVG + HTML 查看器，可选 Draw.io、Excalidraw、Mermaid 等格式，支持深色/浅色模式
5. 下游投影 — 生成 solution.projection.json 供报告生成、幻灯片制作等下游技能消费
CLI 提供完整命令集：--plan（从文本生成）、--export（可视化）、--validate（校验）、--refine（优化）、--project（投影生成）。
显著优点
- 行业语义内置：金融（风控、信贷、合规）、制造（生产计划、质量、供应链）、零售（门店运营、会员、履约）三大垂直领域的术语与检查清单预置，降低领域建模门槛
- 双模式架构：支持传统「架构模式」（capabilities-systems-actors）与「领域知识模式」（knowledge entities），覆盖战略层与战术层不同颗粒度
- 智能路由降级：当
architecture-template、evolution、domain-knowledge等专用渲染路线完整性不足时，自动降级至freeflow通用布局，避免渲染失败 - 下游生态完整：与
report-creator、slide-creator等技能通过solution.projection.json标准化衔接，形成「蓝图→报告→演示」工作流 - 沙箱友好：提供 Jupyter/云 REPL 兼容的
subprocess.run调用模式，规避sys.path.insert与os.system限制
潜在缺点与局限性
- 输入质量敏感：依赖售前材料的结构化程度，模糊或高度口语化的会议记录可能导致实体提取遗漏
- 行业覆盖有限：仅支持四个预设行业，医疗、政务、教育等场景需强行匹配至
common模板，语义提示缺失 - 格式互操作性：Draw.io、Excalidraw 等导出格式依赖外部工具生态，复杂布局可能存在兼容性问题
- Windows 终端限制：Phase 2 未实现 Windows 终端完全对等支持，编码敏感场景需手动设置
PYTHONIOENCODING=utf-8 - 不可编辑约束：下游技能禁止直接修改
solution.blueprint.json，迭代需求需通过--refine或重新生成实现
适合人群
- 解决方案架构师：快速将客户需求转化为能力地图与系统架构图
- 售前咨询顾问：标准化输出商业模式画布、领域大图，提升提案专业度
- 企业 IT 规划团队：构建领域知识库，沉淀业务能力资产
- 产品经理：梳理复杂业务域的参与者、流程与系统交互关系
常规风险
- 数据泄露风险：售前材料可能含敏感客户信息，需确保
projects/workspace/目录访问控制 - schema 版本漂移：
references/下的实体定义、路由规则可能随版本更新，长期项目需锁定 skill 版本 - 渲染完整性误判：机器可读的
evals/export-integrity-thresholds.json与人工审美存在 gap，建议--validate后人工复核关键交付物 - 下游依赖耦合：强制消费
solution.projection.json的下游技能若版本不匹配，可能导致报告/幻灯片生成异常