kit初版,模型引入,agent优化
This commit is contained in:
@@ -12,6 +12,32 @@ alwaysApply: true
|
||||
3. 这些信息帮助 Agent 快速建立位置感:项目进展到什么阶段、最近的工作重心在哪个模块
|
||||
4. 在后续回复中自然参考,不显式提及"根据开发日志"
|
||||
|
||||
## 主动定位辅助
|
||||
|
||||
L3 概要的核心价值之一是帮助 Agent 在**冷启动**(新会话、无上下文)时理解用户意图。
|
||||
当用户的请求缺少具体文件名或模块名时,Agent 应主动利用 L3 进行推断:
|
||||
|
||||
### 典型场景
|
||||
|
||||
1. **隐式延续**:用户说"继续做昨天那个"、"把那个功能完善一下"
|
||||
→ 从 L3 中找到最近的相关条目,上溯到 L2 获取具体文件列表
|
||||
2. **模糊指代**:用户说"那个组件有 bug"、"之前改的那个接口"
|
||||
→ 用 L3 中的关键词匹配用户描述,定位到具体改动
|
||||
3. **上下文补全**:用户直接提出一个任务,没有背景说明
|
||||
→ 用 L3 判断该任务是否与近期某个改动有关联(如同一模块、同一功能线)
|
||||
|
||||
### 流程
|
||||
|
||||
```
|
||||
1. 解析用户请求,识别是否存在隐式引用或模糊指代
|
||||
2. 在 L3 概要中查找语义最匹配的 1-3 条记录
|
||||
3. 提取匹配条目的锚点 ID,上溯到 L2 获取 affected_files 和 tags
|
||||
4. 如有必要,继续上溯到 L1 获取完整的决策背景
|
||||
5. 将定位到的文件/模块作为任务的起点,开始执行
|
||||
```
|
||||
|
||||
如果 L3 中没有匹配到任何相关记录,正常处理即可——不是所有任务都与近期改动有关。
|
||||
|
||||
## L2 自动触发
|
||||
|
||||
Agent 开始处理一个新任务时,判断是否需要读取近期详细记录:
|
||||
@@ -42,7 +68,30 @@ Agent 开始处理一个新任务时,判断是否需要读取近期详细记
|
||||
获取行号后用 Read 工具读取该行号 ±20 行范围
|
||||
4. 一次上溯通常只涉及 1-3 条记录,不批量上溯
|
||||
|
||||
## 被动写入提醒
|
||||
## 任务完成 Checklist(强制)
|
||||
|
||||
Agent 在完成涉及代码/配置文件实质性改动的任务后,应读取 `dev-changelog` Skill
|
||||
并执行其"操作 A:记录写入"流程,静默追加三层记录。
|
||||
Agent 在即将输出最终回复前,**必须**逐项检查以下清单。
|
||||
这是硬性要求,不是建议——**跳过任何一项都视为执行错误**。
|
||||
|
||||
1. **本次是否有代码/配置文件改动?**(不含 `.cursor/` 下的基础设施文件)
|
||||
- 否 → 跳过后续项
|
||||
- 是 → 继续
|
||||
|
||||
2. **是否已写入三层开发日志?**
|
||||
- 否 → **立即**读取 `dev-changelog` Skill 并执行操作 A,写入 L1 + L2 + L3 后再输出回复
|
||||
- 是 → 继续
|
||||
|
||||
3. **是否修改了任何 Skill?**(包括 SKILL.md 内容变更)
|
||||
- 否 → 跳过
|
||||
- 是 → 检查是否已同步 `epee-orchestrator` 的 `registry.md`,未同步则立即执行
|
||||
|
||||
4. **本次是否有 Skill 使用异常?**(遗漏、误触、产物与用户预期偏差)
|
||||
- 否 → 跳过
|
||||
- 是 → 执行 `epee-orchestrator.mdc` 中的自迭代确认流程
|
||||
|
||||
5. **静默 Hook 重复触发**(每次 checklist 完成后必须执行)
|
||||
- 用 Write 工具创建空文件 `.cursor/changelog/.changelog-ack`
|
||||
- 这会更新 ack 文件的 mtime,阻止 `check-changelog.ps1` hook 在后续回复中重复提醒
|
||||
|
||||
**执行原则**:先完成 checklist 中的所有写入动作,再输出面向用户的回复文本。
|
||||
回复末尾如果执行了第 2 项,附 `[已记录到开发日志]`。
|
||||
|
||||
Reference in New Issue
Block a user