pr

使用以下结构撰写 PR Body：

## Summary

<图、diff 草图或树形结构>

## Evidence

- **Before:** <截图、输出或失败的测试>
  **After:** <截图、输出或通过的测试>

## Merge Danger

**Door:** <one-way 或 two-way>

<可选：解释为什么>

**Blast Radius:** <用一个简短词组描述影响范围>

<可选：说明合并可能造成的影响>

通用要求

• 直接从 ## Summary 开始，不写前言。
• 保持文字简短；Reviewer 已经能看到 diff，PR Body 的任务是先让人看懂改动的形状、证据和风险。
• 优先使用仓库 GLOSSARY.md 中的领域语言；没有该文件时沿用仓库和 issue 中的既有术语。
• 只描述实际 diff、真实测试结果和已知风险，不推测不存在的行为，不把“应该通过”写成“已经通过”。

Summary

选择能够说明关键变化的最小视图。可以使用一种，也可以组合少量几种；通常不应全部使用。

用伪代码展示逻辑或算法

保存内容
  如果内容没有变化
    返回缓存结果
  写入新内容
  返回最新结果

用调用树展示运行时控制流

submitForm
  createSession
    persistPrompt
    launchAgent
  navigateToSession

用组件树展示 UI 结构

保留与当前变化有关的状态、模块边界和文件位置：

<SessionPage> (apps/example/src/routes/session.tsx)
  useSessionEvents()
  <SessionToolbar>
    <RunSkillButton> (packages/ui)

用浅层文件树展示职责变化或大范围重构

src/
├── commands/       # 解析用户操作
├── sessions/       # 管理会话状态
└── transport/      # 发送 API 请求

用 Mermaid 展示组件交互、控制流或数据流

sequenceDiagram
    participant User
    participant UI
    participant Daemon
    User->>UI: 选择命令
    UI->>Daemon: 发送展开后的提示词
    Daemon-->>UI: 流式返回结果

用 diff 草图突出结构变化

当读者已经了解原有结构，而重点是“哪里发生了变化”时使用 diff。

组件变化：

 <SessionPage>
   useSessionEvents()
   <SessionToolbar>
+    <RunSkillButton />
   <SessionTimeline>
+    <SkillResultCard />

文件布局变化：

 src/
 ├── commands/
+│   └── show-me.ts       # 展开斜杠命令
 ├── sessions/
-└── transport.ts
+└── transport/
+    ├── client.ts
+    └── stream.ts

调用树变化：

 submitForm
   createSession
     persistPrompt
+    expandSkillMention
     launchAgent
-  navigateToSession
+  navigateToSession
+    subscribeToEvents

状态或控制流变化：

 保存内容
-  写入内容
+  如果内容没有变化
+    返回缓存结果
+  写入内容
+  使缓存失效

必要时展示完整目标代码块

当大部分内容都是新增的、缺少上下文会掩盖职责或顺序，或者读者需要可复制的目标形状时，展示完整代码块：

function expandSkill(command: string): string {
  const skillName = command.slice(1);
  return `use the ${skillName} skill`;
}