# 提示词入口

本目录包含 AI 代理的任务入口模板，用于把任务路由到合适的执行路径。
它是薄入口层，不是流程权威；完整流程与执行约束只在
`AGENT_RULES.md` 定义。

## 目录结构

```text
prompts/
├── README.md              # 本文件
├── system/
│   └── agent-behavior.md  # 入口路由
├── coding/
│   ├── clarify.md         # 需求澄清模板
│   ├── verify-change.md   # 变更验证模板
│   ├── close-task.md      # 本轮收尾模板
│   ├── update-memory.md   # 回写记忆模板
│   └── code-review.md     # MR/PR 代码评审入口
└── custom/                # 可选：项目私有提示词
```

## 使用方式

| 模板                  | 触发场景             |
| --------------------- | -------------------- |
| **agent-behavior.md** | 选择任务入口         |
| **clarify.md**        | 需求不明确时澄清     |
| **verify-change.md**  | 声称完成前做验证     |
| **close-task.md**     | 本轮工作收尾         |
| **update-memory.md**  | 上下文变化后回写记忆 |
| **code-review.md**    | 执行 MR/PR 代码评审  |
| **custom/\*.md**      | 项目私有补充入口     |

## 入口边界

- 需求不明确：看 `clarify.md`
- 需要判断设计、计划或执行路径：先回到 `AGENT_RULES.md`
- 需要验证交付结果：看 `verify-change.md`
- 需要结束本轮并整理交付摘要：看 `close-task.md`
- 需要回写上下文：看 `update-memory.md`
- 需要评审 MR/PR：看 `code-review.md`
- 需要保留设计与计划产物：只写入 `docs/superpowers/`

> `coding/` 下是可被框架覆盖更新的标准入口模板；
> 项目私有补充入口应沉淀到 `custom/`。
>
> `prompts/` 只负责把代理导向正确入口；`AGENT_RULES.md`
> 是唯一流程权威；`AGENT_RULES.local.md` 保存项目私有规则；
> `memory-bank/` 保存项目上下文与状态；`docs/superpowers/`
> 保存设计与计划产物。

---

**最后更新**：{{DATE}}