# Prompts

面向 AI 大模型的提示词集合，每份提示词独立可用，完整复制给 AI 工具即可启动对应流程。

## 命名规则

文件名格式：`prompt-{action}.md`，`{action}` 使用明确无歧义的英文单词或短语，用连字符连接，例如 `prompt-smart-merge.md`、`prompt-spec-review.md`。

## 提示词

| 文件 | 用途 |
| ---- | ---- |
| [prompt-smart-merge.md](prompt-smart-merge.md) | 批量合并 dev 分支到主干，含依赖分析、冲突处理、安全回退 |
| [prompt-spec-review.md](prompt-spec-review.md) | 审查和重构 openspec/specs/ 下的规范文件 |
| [prompt-proposal-review.md](prompt-proposal-review.md) | 审查 openspec 变更文档与讨论内容的一致性 |
| [prompt-apply-review.md](prompt-apply-review.md) | 审查代码实现与 openspec 变更文档的一致性 |

## 书写原则

### 面向 AI 而非人类

- 不写背景知识、适用场景、定期审查节奏等"补充说明"，AI 只需要执行指令
- 不写解释性注释（为什么用 merge 不用 rebase），直接作为约束声明
- 不写示例输出模板，AI 自行推断格式

### 结构

```
一句话描述任务目标

## 约束
全局不可违反的规则，顶部声明，不在步骤中重复

## 1. 收集/准备
## 2. 分析
## 3. 计划（用户确认）
## 4. 执行（用户确认）
## 5. 清理/收尾
```

编号步骤，不用"第X步"（省 token）。步骤之间有确认节点的明确标注。

### 精简

- 每句话只含一条指令，不嵌套子句
- 表格优于列表，列表优于段落
- 规则只声明一次，不在多处重复
- 单文件控制在 150 行以内

### 安全

- 破坏性操作（删除、重写、推送、合并提交）执行前必须用提问工具获得用户确认
- 提供回退机制（安全锚点、备份标记、abort 路径）
- 危险命令的约束直接写在约束块中，不用"严禁""务必"等修饰词，用"禁止"即可
- 信息展示分层渐进（概览 → 详情 → 原始数据），避免一次输出过多内容

### 可操作性

- 给出具体命令或工具调用方式，不抽象描述（"分析分支"→ "git diff --name-status target...branch"）
- 标注并行/串行：可并行的步骤明确写"并行"，有副作用的操作标注"串行"
- 用 `{占位符}` 标记需要 AI 替换的参数