积木设计指南：高质量技能构建

面向问题：当技能设计变成“随意编写”

创建 AI 技能（Skill）时，常见的模式是直接开始写 SKILL.md 和脚本。这导致设计过程模糊、结构松散、产出难以复用，且经常在功能边界、触发条件和输入输出契约上出现缺口。最终交付的技能可能无法稳定工作，或在不同场景下表现不一致。

skill-designer 这个元技能提供了一套系统化的设计方法论，而非代码生成器。它将模糊的想法，通过固定的十个积木步骤（B01–B10），锻造成一份详尽的“技能蓝图”。这份蓝图是后续开发（如交给 skill-creator 落地）的唯一事实源。

核心工作：如何构建技能蓝图

技能设计遵循一个固定的主流水线，每个步骤产出一个积木格文件，共同组成蓝图：

• 起点与路径选择：通过 Phase 0 明确平台、入口（创建/改进）和通道（轻量 MVP 或完整设计）。立即调用 scripts/init_blueprint.py 将蓝图落盘，避免停留在对话记忆中。
• 十个积木格（B01-B10）：

1. B01 条件：用“准入四问”判断这个技能是否值得做。
2. B02 事实：明确目标用户画像和场景，检查生态是否有重叠。
3. B03 观点：根据交互与内容模式，选择设计处方并给出依据。
4. B04 问题：列出所有待定的需求和口径，明确决策者。
5. B05 分析：定义输入/输出契约和潜在风险。
6. B06 决策：做出方案抉择（如拆分或合并），并约定产出文件的格式。
7. B07 计划：绘制施工图，确定目录骨架和实施顺序。可用 scripts/visualize_blueprint.py 生成可视化图。
8. B08 行动：设计真实场景进行验证，对比使用前后的效果。
9. B09 结果：通过质量门。机器自动计算 IQS（蓝图完备度），人工评估 BR-5 五维就绪度。可用 scripts/b09_summary.py 生成摘要图。
10. B10 复盘：归纳失败教训，提炼出可跨任务复用的通用规则，进入经验库（lessons.md）。

整个过程由一系列脚本工具辅助（如 check_blueprint.py 用于中断恢复和缺口检查），但脚本不可用时可降级为纯对话引导，不阻塞流程。

适用边界与重要纪律

• 它是什么：这是一个设计指南和蓝图构建器。它引导产出设计文档（蓝图），而不是直接编写技能代码。蓝图定稿后，需要交接给其他工具（如 skill-creator）进行开发。
• 它不是什么：它不用于安装、推荐、调度已存在的技能，也不用于编写一次性脚本或进行概念闲聊。
• 关键纪律：

- 强制阻塞：技能的触发词和名称必须由用户亲自确认，AI 不能代填。
- 决策权归属：设计师提供草稿和依据，但需求判定、设计模式选择、评分确认等关键决策，最终由用户拍板。
- 蓝图是唯一事实源：后续任何开发如果偏离蓝图，都应回到蓝图进行修正，而不是默许偏离。

该指南旨在让技能设计从“灵感驱动”变为“结构驱动”，确保产出可链接、可复用、可衡量的能力模块。