核心用法
Business Blueprint Skill 是一套面向售前与解决方案设计的结构化文档生成工具。其核心工作流围绕 solution.blueprint.json 这一单一事实来源展开，通过命令式接口（--plan、--generate、--edit、--validate、--export）将非结构化的需求输入转化为标准化的业务能力蓝图。
典型使用场景：
- 冷启动阶段：使用
--plan从会议纪要或需求文档中提取业务实体、泳道流程和架构组件，生成初始 JSON 蓝图 - 迭代完善：通过
--generate或--edit刷新静态 HTML 查看器，支持可视化审阅 - 质量把关：使用
--validate检查结构完整性和字段锁定状态，确保下游消费可靠 - 成果交付：通过
--export批量生成 SVG（快速预览）、draw.io（可编辑）、Excalidraw（白板风格）、Mermaid（GitHub 原生渲染）四种格式的图表文件
协作边界设计： 该技能定位为"语义中间件生产者"，明确禁止下游技能（如 report-creator、slide-creator）直接编辑 JSON 源文件，而是通过 relations 字段消费结构化数据。这种设计保障了架构一致性和变更可追溯性。
显著优点
1. 单一事实来源（SSOT）：强制以 solution.blueprint.json 为唯一权威，避免 HTML 查看器与源数据脱节
2. 字段锁定机制：editor.fieldLocks 保护人工编辑字段不被自动化流程覆盖，兼顾自动化与人机协作
3. 多格式无缝导出：一套数据驱动四种主流图表生态，适配不同协作场景（技术评审用 draw.io、GitHub 文档用 Mermaid、演示用 SVG）
4. 沙箱原生支持：针对 Jupyter/Notebook 环境提供免 __file__ 的纯 Python 调用模式，规避常见运行时错误
5. 前置校验机制：--validate 在导出前强制拦截结构性错误，降低下游消费失败率
潜在缺点与局限性
1. Python 版本门槛：要求 Python ≥ 3.12，老旧环境需降级使用 CLI 回退方案
2. 语义提取黑盒性：--plan 阶段对"过于模糊的需求"仅生成 minimal output 并抛出 clarifyRequests，实际 NLP 能力未在文档中量化说明
3. 导出格式功能不等价：Mermaid 导出为 Markdown 代码块，交互能力弱于 draw.io 的原生编辑支持
4. 无实时协同：静态 HTML 查看器不支持多人同时编辑，需依赖外部版本控制协调变更
5. 行业模板有限：--industry 参数仅示例为 "common"，垂直行业（金融、医疗等）的预设实体库覆盖度不明
适合人群
- 售前解决方案架构师：快速将客户访谈转化为结构化交付物
- 业务分析师（BA）：需要统一需求表达与系统架构视图的衔接者
- 技术文档工程师：为报告/演示生成可版本控制的图表源文件
- 敏捷团队技术负责人：在 Sprint 规划中将用户故事映射到业务能力组件
常规风险
- 数据丢失风险：若未正确配置
fieldLocks，自动化重新生成可能覆盖手工调整的业务描述 - 版本漂移风险：多格式导出后若未及时同步更新，可能导致 SVG 与 draw.io 文件内容不一致
- 沙箱兼容陷阱：开发者若习惯性使用
__file__或subprocess调用，将在 Jupyter 环境遭遇运行时错误 - 下游误用风险：协作边界规则若未被下游技能遵守，可能引发循环依赖或数据污染