nex/docs/prompts/README.md

Prompts

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

提示词

文件	用途
智能合并.md	批量合并 dev 分支到主干，含依赖分析、冲突处理、安全回退
规范整理.md	审查和重构 openspec/specs/ 下的规范文件

书写原则

面向 AI 而非人类

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

结构

一句话描述任务目标

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

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

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

精简

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

安全

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

可操作性

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