contract-diagram合约图

图例	描述
	尚未讨论

SKILL 合约图 ℹ️

mermaid
%%{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 CHECKDIAGRAM,CREATE,CLAIM,ERROR,SIGNOFF,DESIGN,DEVELOPMENT,BLOCKERS,CHECKCONTRACT,OPEN,CLARIFY,TRIGGER developed
class PUBLISH,TESTS outside

1️⃣ 包装器在首次加载时自动注入标题 + 阶段徽章 + CSS，并监视徽章上阶段的变化。

2️⃣ 多个图表会使系统混淆。目前，每个 md 文件只能有一个图表才能运行。

3️⃣ 检查和发布取决于最终产品的去向和方式，因此由用户自行决定。

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

何时使用：

执行前（设计阶段）：

• - 需要讨论的问题
• 需要决策的权衡
• 不明确的需求

执行期间：

• - AI 无法独立解决的错误
• 需要权限（破坏性操作、成本影响）
• 实现中的歧义

格式：

markdown

1️⃣ [组件名称] - [问题标题]

没有编号的备注 = 仅为解释，批准后变为黄色。

本地主机触发器

触发器： 让我们绘制图表 [路径]

假设： 路径处的文件已有 mermaid 图表。

操作：

1. 1. 启动本地主机服务器（端口 8080）
2. 在浏览器中打开图表

示例：

用户：让我们绘制 epic-notes/webhook-contract.md 的图表

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

默认启用热重载（2 秒间隔）。