60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# 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/ 下的规范文件 |
|
||
|
||
## 书写原则
|
||
|
||
### 面向 AI 而非人类
|
||
|
||
- 不写背景知识、适用场景、定期审查节奏等"补充说明"，AI 只需要执行指令
|
||
- 不写解释性注释（为什么用 merge 不用 rebase），直接作为约束声明
|
||
- 不写示例输出模板，AI 自行推断格式
|
||
|
||
### 结构
|
||
|
||
```
|
||
一句话描述任务目标
|
||
|
||
## 约束
|
||
全局不可违反的规则，顶部声明，不在步骤中重复
|
||
|
||
## 1. 收集/准备
|
||
## 2. 分析
|
||
## 3. 计划（用户确认）
|
||
## 4. 执行（用户确认）
|
||
## 5. 清理/收尾
|
||
```
|
||
|
||
编号步骤，不用"第X步"（省 token）。步骤之间有确认节点的明确标注。
|
||
|
||
### 精简
|
||
|
||
- 每句话只含一条指令，不嵌套子句
|
||
- 表格优于列表，列表优于段落
|
||
- 规则只声明一次，不在多处重复
|
||
- 单文件控制在 150 行以内
|
||
|
||
### 安全
|
||
|
||
- 破坏性操作（删除、重写、推送、合并提交）执行前必须用提问工具获得用户确认
|
||
- 提供回退机制（安全锚点、备份标记、abort 路径）
|
||
- 危险命令的约束直接写在约束块中，不用"严禁""务必"等修饰词，用"禁止"即可
|
||
- 信息展示分层渐进（概览 → 详情 → 原始数据），避免一次输出过多内容
|
||
|
||
### 可操作性
|
||
|
||
- 给出具体命令或工具调用方式，不抽象描述（"分析分支"→ "git diff --name-status target...branch"）
|
||
- 标注并行/串行：可并行的步骤明确写"并行"，有副作用的操作标注"串行"
|
||
- 用 `{占位符}` 标记需要 AI 替换的参数
|