docs: 优化 prompts 提示词,面向 AI 精简 token 并新增书写原则
This commit is contained in:
55
docs/prompts/README.md
Normal file
55
docs/prompts/README.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Prompts
|
||||
|
||||
面向 AI 大模型的提示词集合,每份提示词独立可用,完整复制给 AI 工具即可启动对应流程。
|
||||
|
||||
## 提示词
|
||||
|
||||
| 文件 | 用途 |
|
||||
| ---- | ---- |
|
||||
| [智能合并.md](智能合并.md) | 批量合并 dev 分支到主干,含依赖分析、冲突处理、安全回退 |
|
||||
| [规范整理.md](规范整理.md) | 审查和重构 openspec/specs/ 下的规范文件 |
|
||||
|
||||
## 书写原则
|
||||
|
||||
### 面向 AI 而非人类
|
||||
|
||||
- 不写背景知识、适用场景、定期审查节奏等"补充说明",AI 只需要执行指令
|
||||
- 不写解释性注释(为什么用 merge 不用 rebase),直接作为约束声明
|
||||
- 不写示例输出模板,AI 自行推断格式
|
||||
|
||||
### 结构
|
||||
|
||||
```
|
||||
一句话描述任务目标
|
||||
|
||||
## 约束
|
||||
全局不可违反的规则,顶部声明,不在步骤中重复
|
||||
|
||||
## 1. 收集/准备
|
||||
## 2. 分析
|
||||
## 3. 计划(用户确认)
|
||||
## 4. 执行(用户确认)
|
||||
## 5. 清理/收尾
|
||||
```
|
||||
|
||||
编号步骤,不用"第X步"(省 token)。步骤之间有确认节点的明确标注。
|
||||
|
||||
### 精简
|
||||
|
||||
- 每句话只含一条指令,不嵌套子句
|
||||
- 表格优于列表,列表优于段落
|
||||
- 规则只声明一次,不在多处重复
|
||||
- 单文件控制在 150 行以内
|
||||
|
||||
### 安全
|
||||
|
||||
- 破坏性操作(删除、重写、推送、合并提交)执行前必须用提问工具获得用户确认
|
||||
- 提供回退机制(安全锚点、备份标记、abort 路径)
|
||||
- 危险命令的约束直接写在约束块中,不用"严禁""务必"等修饰词,用"禁止"即可
|
||||
- 信息展示分层渐进(概览 → 详情 → 原始数据),避免一次输出过多内容
|
||||
|
||||
### 可操作性
|
||||
|
||||
- 给出具体命令或工具调用方式,不抽象描述("分析分支"→ "git diff --name-status target...branch")
|
||||
- 标注并行/串行:可并行的步骤明确写"并行",有副作用的操作标注"串行"
|
||||
- 用 `{占位符}` 标记需要 AI 替换的参数
|
||||
Reference in New Issue
Block a user