---
description: 会话中按需回忆开发日志，并在完成变更时维护多人 fragment、踩坑记录与 Skill registry
alwaysApply: true
---

# 开发日志回忆与收尾

## 会话开始

1. 读取 `.cursor/changelog/changelog-headlines.md`；不存在或只有模板时跳过。
2. 当前任务与近期模块、标签或文件相关时，再读取 `.cursor/changelog/changelog-recent.md` 中的相关条目。
3. 条目仍有歧义时，按记录 ID 精确查找对应 fragment 或只读取 `changelog-full.md` 的局部范围；不要无条件加载完整历史。
4. 日志只作为背景事实使用，不用在回复中刻意声明来源。

## 变更日志写入

完成有实质影响的代码、配置或文档变更后：

1. 读取 `.cursor/skills/dev-changelog/SKILL.md` 并遵循其当前流程；文件不存在时说明无法记录，不自行发明格式。
2. 从 `.cursor/local-env.json` 获取稳定的 `changelog-author`；缺失时先询问用户。
3. 每次记录都新建独立 fragment：`.cursor/changelog/entries/<author>/<id>.md`；不得复用或覆盖他人的 fragment，以避免多人修改同一文件。
4. 不直接编辑生成视图；按 Skill 指定的生成器重建并校验视图。

## 踩坑信号自检

最终回复前快速判断本次任务是否出现了非显而易见的运行时、构建、配置、版本或工具链问题，尤其是：

- 报错后经过排查才定位根因；
- 只看代码无法预见，实际执行才暴露；
- 同一问题在会话中重复出现。

命中时读取 `.cursor/skills/pitfall-journal/SKILL.md`，按其写入流程记录；纯拼写、显然语法错误或普通业务调整不记录。开发日志中的摘要不能替代可检索的踩坑记录。

## Skill 一致性

- 创建、删除、重命名或修改任何 Skill 后，同步 `.cursor/skills/epee-orchestrator/registry.md`，确保名称、入口、能力描述与触发条件一致。
- Skill 使用出现遗漏、误触或系统性偏差时，按 `epee-orchestrator` Skill 的自迭代流程处理。
- 用户明确限制可修改路径时，以该限制为准：报告未能执行的日志或 registry 写入，不越权修改。