playbook/templates/prompts/README.md

56 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 提示词入口
本目录包含 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}}