📦 deps(playbook): sync rules, prompts, memory-bank
This commit is contained in:
@@ -0,0 +1,48 @@
|
||||
# 提示词库
|
||||
|
||||
本目录包含 AI 代理的工作流程参考模板。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```text
|
||||
prompts/
|
||||
├── README.md # 本文件
|
||||
├── system/
|
||||
│ └── agent-behavior.md # 工作模式参考
|
||||
├── coding/
|
||||
│ ├── clarify.md # 需求澄清模板
|
||||
│ └── review.md # 复盘总结模板
|
||||
└── meta/
|
||||
└── prompt-generator.md # 元提示词生成器
|
||||
```
|
||||
|
||||
## 使用方式
|
||||
|
||||
| 模板 | 触发场景 |
|
||||
| ----------------------- | ------------------------------ |
|
||||
| **agent-behavior.md** | 切换工作模式（探索/开发/调试） |
|
||||
| **clarify.md** | 需求不明确时澄清 |
|
||||
| **review.md** | Plan 完成后复盘总结 |
|
||||
| **prompt-generator.md** | 创建新的专用提示词 |
|
||||
|
||||
## 工作流程
|
||||
|
||||
```
|
||||
需求不清 → clarify.md
|
||||
↓
|
||||
头脑风暴 → $brainstorming skill
|
||||
↓
|
||||
生成计划 → $writing-plans skill → docs/plans/*.md
|
||||
↓
|
||||
执行计划 → AGENT_RULES 主循环（留痕）
|
||||
↓
|
||||
完成复盘 → review.md
|
||||
↓
|
||||
沉淀提示词 → prompt-generator.md（可选）
|
||||
```
|
||||
|
||||
> **核心规则在 `AGENT_RULES.md`**，第三方 skills 负责规划，主循环负责执行和留痕。
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
@@ -0,0 +1,52 @@
|
||||
# 需求澄清模板
|
||||
|
||||
<!--
|
||||
按需使用：当需求不明确或存在歧义时参考本模板。
|
||||
Vibe-coding 场景下可跳过，直接开始实现。
|
||||
-->
|
||||
|
||||
## 何时使用
|
||||
|
||||
- 需求描述不明确
|
||||
- 存在多种理解方式
|
||||
- 缺少关键信息
|
||||
|
||||
---
|
||||
|
||||
## 澄清步骤
|
||||
|
||||
### 1. 复述需求
|
||||
|
||||
```text
|
||||
我理解你的需求是：[用自己的话复述]
|
||||
```
|
||||
|
||||
### 2. 识别歧义
|
||||
|
||||
- 歧义 1：[描述不明确的地方]
|
||||
- 歧义 2：[可能有多种理解的地方]
|
||||
|
||||
### 3. 提出问题
|
||||
|
||||
> 只问阻塞问题，最多 1–2 个；优先给出选项让用户选择。
|
||||
|
||||
- 这个功能是否包括 [场景 A]？
|
||||
- 当 [条件 X] 时，应该 [行为 Y] 还是 [行为 Z]？
|
||||
|
||||
### 4. 提供选项
|
||||
|
||||
**选项 A**：[方案描述]
|
||||
|
||||
- 优点：...
|
||||
- 缺点：...
|
||||
|
||||
**选项 B**：[方案描述]
|
||||
|
||||
- 优点：...
|
||||
- 缺点：...
|
||||
|
||||
**推荐**：[推荐哪个，为什么]
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
@@ -0,0 +1,66 @@
|
||||
# 复盘模板
|
||||
|
||||
<!--
|
||||
用途：Plan 或阶段完成后的回顾总结
|
||||
触发：主循环汇总报告时、阶段性工作完成时
|
||||
-->
|
||||
|
||||
## 何时使用
|
||||
|
||||
- 一批 Plan 执行完毕后
|
||||
- 阶段性工作告一段落
|
||||
- 遇到重大阻塞需要总结
|
||||
|
||||
---
|
||||
|
||||
## 复盘格式
|
||||
|
||||
```markdown
|
||||
# 复盘: [日期/阶段名称]
|
||||
|
||||
## 完成情况
|
||||
|
||||
### 已完成
|
||||
- [x] Plan 1: 简述
|
||||
- [x] Plan 2: 简述
|
||||
|
||||
### 阻塞
|
||||
- [ ] Plan 3: 阻塞原因
|
||||
|
||||
### 跳过
|
||||
- [ ] Plan 4: 跳过原因
|
||||
|
||||
## 关键发现
|
||||
|
||||
### 做得好的
|
||||
- 发现1
|
||||
- 发现2
|
||||
|
||||
### 待改进
|
||||
- 问题1 → 建议改进方式
|
||||
- 问题2 → 建议改进方式
|
||||
|
||||
## 决策记录
|
||||
|
||||
| 决策 | 理由 | 影响 |
|
||||
|------|------|------|
|
||||
| 决策1 | 为什么 | 影响范围 |
|
||||
|
||||
## 下一步
|
||||
|
||||
- [ ] 待处理事项1
|
||||
- [ ] 待处理事项2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 复盘原则
|
||||
|
||||
- **客观记录**：如实记录完成/阻塞/跳过
|
||||
- **提取经验**：总结做得好的和待改进的
|
||||
- **决策留痕**：重要决策记录到 decisions.md
|
||||
- **明确下一步**：列出后续待处理事项
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
@@ -0,0 +1,126 @@
|
||||
# 提示词生成器（元提示词）
|
||||
|
||||
<!--
|
||||
用途：根据场景自动生成专用提示词
|
||||
原理：α-prompts（生成）+ Ω-prompts（优化）递归循环
|
||||
-->
|
||||
|
||||
## 何时使用
|
||||
|
||||
- 需要为新场景创建专用提示词
|
||||
- 现有提示词不满足特定需求
|
||||
- 需要批量生成同类提示词
|
||||
|
||||
---
|
||||
|
||||
## 生成流程（α循环）
|
||||
|
||||
### 1. 分析场景
|
||||
|
||||
```markdown
|
||||
**场景名称**：[名称]
|
||||
**目标用户**：[AI/人类/两者]
|
||||
**触发条件**：[何时使用这个提示词]
|
||||
**预期输出**：[使用后应该产出什么]
|
||||
```
|
||||
|
||||
### 2. 提取约束
|
||||
|
||||
```markdown
|
||||
**必须做**：
|
||||
- 约束1
|
||||
- 约束2
|
||||
|
||||
**禁止做**：
|
||||
- 禁止1
|
||||
- 禁止2
|
||||
|
||||
**边界条件**：
|
||||
- 边界1
|
||||
- 边界2
|
||||
```
|
||||
|
||||
### 3. 生成草稿
|
||||
|
||||
```markdown
|
||||
# [提示词标题]
|
||||
|
||||
<!--
|
||||
用途：[一句话描述]
|
||||
触发：[触发条件]
|
||||
-->
|
||||
|
||||
## 何时使用
|
||||
|
||||
- 场景1
|
||||
- 场景2
|
||||
|
||||
## [核心内容]
|
||||
|
||||
[根据场景填充]
|
||||
|
||||
## [约束/原则]
|
||||
|
||||
- 约束1
|
||||
- 约束2
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 优化流程（Ω循环）
|
||||
|
||||
### 1. 评估维度
|
||||
|
||||
| 维度 | 问题 |
|
||||
| ---------- | ---------------------- |
|
||||
| **清晰度** | 指令是否明确无歧义？ |
|
||||
| **完整度** | 是否覆盖所有必要场景？ |
|
||||
| **简洁度** | 是否有冗余内容可删除？ |
|
||||
| **可操作** | AI 能否直接执行？ |
|
||||
|
||||
### 2. 迭代优化
|
||||
|
||||
```
|
||||
草稿 → 评估 → 修改 → 再评估 → ... → 定稿
|
||||
```
|
||||
|
||||
### 3. 验证测试
|
||||
|
||||
- 用实际场景测试提示词效果
|
||||
- 收集反馈，持续迭代
|
||||
|
||||
---
|
||||
|
||||
## 提示词模板库
|
||||
|
||||
### 标准结构
|
||||
|
||||
```markdown
|
||||
# [标题]
|
||||
|
||||
<!--
|
||||
用途：
|
||||
触发：
|
||||
-->
|
||||
|
||||
## 何时使用
|
||||
## [核心内容]
|
||||
## [约束/原则]
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
```
|
||||
|
||||
### 命名规范
|
||||
|
||||
- 文件名：`[动词]-[对象].template.md`
|
||||
- 示例：`clarify-requirement.template.md`
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
@@ -0,0 +1,62 @@
|
||||
# 工作模式参考
|
||||
|
||||
<!--
|
||||
本文件定义三种工作模式，供 AI 根据任务类型选择。
|
||||
核心规则（安全红线、验证清单等）见 AGENT_RULES.md。
|
||||
-->
|
||||
|
||||
## 模式 1: 探索模式（Explore）
|
||||
|
||||
**目的**：理解代码库、分析问题、收集信息
|
||||
|
||||
**行为**：
|
||||
|
||||
- 使用搜索工具探索代码
|
||||
- 输出分析报告和发现
|
||||
- 不修改任何代码
|
||||
|
||||
**适用场景**：
|
||||
|
||||
- 理解某个模块的实现
|
||||
- 分析 bug 的根本原因
|
||||
- 评估功能实现的可行性
|
||||
|
||||
---
|
||||
|
||||
## 模式 2: 开发模式（Develop）
|
||||
|
||||
**目的**：实现功能、修复 bug、重构代码
|
||||
|
||||
**行为**：
|
||||
|
||||
- 先读取相关文件，理解现有逻辑
|
||||
- 进行精确修改
|
||||
- 修改后运行测试验证
|
||||
|
||||
**适用场景**：
|
||||
|
||||
- 实现新功能
|
||||
- 修复已知 bug
|
||||
- 优化性能
|
||||
|
||||
---
|
||||
|
||||
## 模式 3: 调试模式（Debug）
|
||||
|
||||
**目的**：诊断问题、对比差异、验证行为
|
||||
|
||||
**行为**：
|
||||
|
||||
- 收集相关日志和输出
|
||||
- 分析差异原因
|
||||
- 修复后重新验证
|
||||
|
||||
**适用场景**：
|
||||
|
||||
- 测试失败
|
||||
- 输出不符合预期
|
||||
- 性能问题诊断
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-02-02
|
||||
Reference in New Issue
Block a user