39 lines
2.1 KiB
Plaintext
39 lines
2.1 KiB
Plaintext
---
|
||
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 写入，不越权修改。
|