SKILL 合约流程图 ℹ️

%%{init: {'theme':'base','themeVariables':{"primaryColor":"#4A90E2","primaryTextColor":"#fff","primaryBorderColor":"#2E5C8A","lineColor":"#666","secondaryColor":"#50E3C2","tertiaryColor":"#FFD700","edgeLabelBackground":"#666"},'flowchart':{"nodeSpacing":50,"rankSpacing":50,"padding":15,"curve":"basis"}}}%%
flowchart TD
    TRIGGER["触发器 + 合约"]
    CHECK_CONTRACT{"是否存在合约？"}
    OPEN["打开合约"]
    CLARIFY["澄清需求"]
    CHECK_DIAGRAM{"是否存在流程图？"}
    CREATE["新建 1️⃣"]
    CLAIM["已认领 1️⃣"]
    ERROR["错误 2️⃣"]
    
    DESIGN["设计阶段"]
    SIGNOFF["准备审批"]
    DEVELOPMENT["开发中..."]
    BLOCKERS{"是否存在阻塞项？"}
    TESTS{"是否通过检查？ 3️⃣"}
    PUBLISH["发布 3️⃣"]
    
    TRIGGER --> CHECK_CONTRACT
    CHECK_CONTRACT -->|是| OPEN
    CHECK_CONTRACT -->|是，但
不可编辑| ERROR
    CHECK_CONTRACT -->|否| CLARIFY
    CLARIFY --> TRIGGER
    
    OPEN --> CHECK_DIAGRAM
    CHECK_DIAGRAM -->|是，且
存在多个| ERROR
    CHECK_DIAGRAM -->|是，仅一个| CLAIM
    CHECK_DIAGRAM -->|否| CREATE
    
    CREATE --> DESIGN
    CLAIM --> DESIGN
    DESIGN --> SIGNOFF
    SIGNOFF -->|已批准| DEVELOPMENT
    DEVELOPMENT --> BLOCKERS
    BLOCKERS -->|是| DESIGN
    BLOCKERS -->|否| TESTS
    TESTS -->|是| PUBLISH
    TESTS -->|否| DESIGN
    
    classDef default fill:#e0e0e0,stroke:#666,color:#000
    classDef approved fill:#FFF9C4,stroke:#F9A825,color:#000
    classDef developed fill:#D5F5D5,stroke:#388E3C,color:#000
    classDef blocker fill:#FFCDD2,stroke:#D32F2F,color:#000
    classDef notes fill:#E3F2FD,stroke:#1976D2,color:#000
    classDef outside fill:#D5F5D5,stroke:#388E3C,stroke-dasharray:5 5,color:#000
    
    class CHECK_DIAGRAM,CREATE,CLAIM,ERROR,SIGNOFF,DESIGN,DEVELOPMENT,BLOCKERS,CHECK_CONTRACT,OPEN,CLARIFY,TRIGGER developed
    class PUBLISH,TESTS outside

1️⃣ 封装器在首次加载时自动注入标题 + 阶段徽章 + CSS，并持续监听徽章所标识阶段的变化。

2️⃣ 多个流程图会导致系统混淆。目前为保障正常运行，每个 Markdown 文件仅支持一个流程图。

3️⃣ 检查与发布行为取决于最终产物的内容及目标位置，因此由用户自行判断和决定。

编号备注（1️⃣ 2️⃣ 3️⃣）

使用时机：

执行前（设计阶段）：

• 需组织讨论的问题
• 需做出权衡取舍的决策点
• 需求不明确或存在歧义的部分

执行过程中：

• AI 无法独立解决的错误
• 需要人工授权的操作（如破坏性操作、涉及成本影响等）
• 实现路径存在模糊或不确定之处

格式规范：

### 1️⃣ [组件名称] - [问题标题]
**问题/错误：** ...
**上下文：** ...
**可选方案：** A、B、C
**所需支持：** 决策 / 授权 / 协助

未编号的备注仅作解释说明之用；经批准后将显示为黄色。

本地开发环境触发方式

触发指令： “lets diagram [PATH]”

前提假设： 指定 PATH 路径下的文件已包含 Mermaid 流程图。

执行动作：

1. 启动本地服务器（端口 8080）
2. 在浏览器中打开对应流程图页面

示例：

User: "lets diagram epic-notes/webhook-contract.md"

AI executes:
  cd ~/Documents/skills/contract-diagram/engine
  ./serve.sh &
  open "http://localhost:8080/?md=../../epic-notes/webhook-contract.md"

默认启用热重载功能（刷新间隔为 2 秒）。