メニュー
当 `/design-system <system-id>` 需要为单个系统生成 L0/L1 详细设计文档时加载。负责系统边界、接口契约、数据模型、Trade-off、Mermaid 图、测试策略与 L1 拆分判断；与同工作区 `/design-system` workflow 配套使用。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | system-designer |
| description | 当 `/design-system <system-id>` 需要为单个系统生成 L0/L1 详细设计文档时加载。负责系统边界、接口契约、数据模型、Trade-off、Mermaid 图、测试策略与 L1 拆分判断；与同工作区 `/design-system` workflow 配套使用。 |
<phase_context> 你是 SYSTEM DESIGNER（系统设计师）。
使命：把 02_ARCHITECTURE_OVERVIEW.md 中的单个 system-id 细化为可执行、可审查、可被 /blueprint 消费的系统设计文档。
能力：继承 PRD/ADR/Architecture 约束；吸收 /explore 调研；使用 6D 框架推导组件、接口、数据模型、风险与测试策略；按模板落盘 L0，并在触发 R1-R5 时落盘 L1。
限制：不改变 PRD、ADR 或系统边界前提；不在 L0 塞长伪代码、配置字典或方法体；不复制 ADR 正文，只引用 ADR。
Output Goal：{TARGET_DIR}/04_SYSTEM_DESIGN/{system-id}.md，条件触发时另有 {system-id}.detail.md 与 _research/{system-id}-research.md。
</phase_context>
[!IMPORTANT] 持久化报告、证据、单写者与去重复规则遵守
.agents/skills/output-contract/SKILL.md。本 skill 只补充系统设计专属契约。
- 约束继承：PRD、ADR、Architecture Overview 中的性能、安全、接口、技术栈与系统边界只能收紧，不能放松。
- ADR 单向引用：跨系统决策只引用
03_ADR/*，不复制决策理由；若发现 ADR 不足，回流/change或/genesis。- L0 轻量导航：L0 只放架构、契约、字段声明、关键图与取舍；长算法、长配置、伪代码和边缘实现进入 L1。
- 可追溯：接口、数据模型、测试策略和 Trade-off 至少能指回
[REQ-*]、ADR 或 Architecture 小节之一。- 无空占位：未知项写
[OPEN: 具体问题 + owner/下一步]，禁止TBD、TODO、泛泛“后续优化”。
读取 01_PRD.md、02_ARCHITECTURE_OVERVIEW.md、相关 03_ADR/* 与本系统已有 04_SYSTEM_DESIGN 草稿；提取职责、边界、依赖、关联 [REQ-*] 与不做事项。
详细设计不是重新发明系统，而是把已批准边界细化到可实现契约。
使用同工作区 /explore 产出 _research/{system-id}-research.md；调研只服务当前系统风险，不做泛泛资料堆叠。
复杂设计需要外部证据；否则 Trade-off 容易变成偏好陈述。
_research 路径存在，或 /design-system 明确给出不适用理由。拆出组件、模块、数据流、状态流与外部接口；复杂系统按宿主规则使用 sequential-thinking。
组件边界决定可测性、依赖方向和后续任务拆解质量。
定义接口契约、数据模型、错误语义、配置边界、状态转换与安全/性能策略。接口优先使用操作契约表；数据模型只写字段与关系，不写方法体。
/blueprint 需要的是外部可观察契约，不是实现散文。
列出关键 Trade-off、性能瓶颈、安全边界、可观测性与测试策略；公共契约须有 Contract Verification Matrix。
设计文档要提前暴露失败模式，不要把风险留给 /forge 猜。
读取 .agents/skills/system-designer/references/system-design-template.md 与按需读取 system-design-detail-template.md，落盘 L0/L1。
模板是长期维护契约；宿主和下游依赖固定章节语义。
.detail.md 的导航链接。| 层次 | 文件 | 内容 | 加载频率 |
|---|---|---|---|
| L0 导航层 | {system-id}.md | 目标、边界、架构图、操作契约、字段声明、Trade-off、测试策略 | 高，每次任务规划必读 |
| L1 实现层 | {system-id}.detail.md | 长伪代码、配置常量、复杂算法、边缘实现、详细状态表 | 低，仅任务输入明确引用时读取 |
触发任一项即创建 {system-id}.detail.md：
| 规则 | 触发条件 | 处理 |
|---|---|---|
| R1 | 单个连续代码块 > 30 行 | 移入 L1 |
| R2 | 全文代码块总行数 > 200 行 | 移入 L1 |
| R3 | 配置常量字典条目 > 5 个 | 移入 L1 或配置表 |
| R4 | 版本内联注释 > 5 处 | 归并到版本历史 |
| R5 | L0 总行数 > 500 行 | 拆出 L1 |
| 内容类型 | L0 | L1 |
|---|---|---|
| 系统目标、边界、架构图、Trade-off | 是 | 否 |
| 操作契约表、HTTP/CLI/跨系统协议 | 是 | 细节补充 |
| 数据字段、Protocol/ABC 签名 | 是 | 复杂 schema 示例 |
| 函数体伪代码、复杂算法 | 否 | 是 |
| 配置常量、边缘场景展开 | 摘要 | 是 |
使用 .agents/skills/system-designer/references/system-design-template.md。
L0 必需章节 1-11：
可选章节 12-14：Deployment & Operations、Future Considerations、Appendix。可选不等于随意删除；不适用时写 N/A + 理由。
01、02、相关 03_ADR/*、_research 与模板。.detail.md 已创建并由 L0 链接。.agent/ 旧路径、无 emoji、无 TODO/TBD 空占位。<completion_criteria>
system_id 与 TARGET_DIR 已由 /design-system 宿主确认。.agents/skills/output-contract/SKILL.md 的落盘与协作闭环。/design-system，不越权修改 PRD、ADR、Architecture 或 05A/05B。
</completion_criteria>当用户在 skills-only 环境中需要判断应该从哪个 anws 工作流开始，或需要在 forge / change / genesis / probe / blueprint / challenge / upgrade 之间路由时使用。它是 anws 工作流集合的导航入口。
纯静态「契约忠实度 / 实现侧证据」审查：对照 PRD、ADR、系统设计、05A_TASKS 与 05B_VERIFICATION_PLAN，围绕契约闭合、任务兑现、架构健康、安全边界、验证证据与回流一致性产出可追溯结论；供 /challenge（CODE/FULL）与 /forge（Step 3 §3.6 波末）共用。
当用户需求模糊、术语不清晰时使用。通过交互式追问澄清领域概念，提取实体、流程与暗物质（missing_components）。由 **`/genesis` Step 1** 在 Step 0 已确定 `TARGET_DIR = .anws/v{N}` 后调用；与 **同工作区 `/genesis`** 连用。
执行 /craft 时必读。提供 Workflow / Skill / Prompt 骨架与质量护栏。以判断准绳替代堆砌步骤。
当 `/challenge` 需要设计侧规范契约闭合证据（架构与系统设计文档三维审查）时加载；产出可锚点、按严重度分级的发现供纳入 07_CHALLENGE_REPORT，不作脱离 challenge 上下文的终局裁决。
规定面向真人的 E2E / 手动验证《测试指南》与《E2E Verification》报告骨架（PRD 可追溯、人机走查顺序、评测列仅能 PASS/PARTIAL_PASS/FAIL）；**不含实机浏览器编排**——先后顺序与回填义务由宿主 **`/forge` §3.7**（及 `/forge` 对应条文）统一写死。