forge_admin/code-copilot/AGENTS.md

code-copilot/AGENTS.md

code-copilot 目录工作指引。根目录 AGENTS.md 仍是最高优先级规则。

1. 适用范围

本文件适用于 code-copilot/ 下的规则、变更、Agent prompt 和知识文档维护。

优先级从高到低：

1. 根目录 AGENTS.md
2. 当前变更目录 code-copilot/changes/[变更名]/spec.md
3. 当前变更目录 tasks.md、execution-log.md、test-spec.md
4. code-copilot/rules/ 下的专项规则
5. 本文件

2. 记忆文件迁移位置

以下三类长期记忆统一迁移并维护在 code-copilot/memory/，不要再在 .opencode/memory/ 下维护同名副本：

类型	权威文件
项目决策	code-copilot/memory/decisions.md
踩坑记录	code-copilot/memory/pitfalls.md
用户偏好	code-copilot/memory/preferences.md

每次新会话、执行 /test、阶段验证、Review 修复或归档前验收时，必须先读取这三个文件，再读取当前变更的 spec/tasks/log。

3. 写入规则

• 架构、产品、技术路线等长期选择写入 code-copilot/memory/decisions.md。
• 可复用问题、根因、规避方式写入 code-copilot/memory/pitfalls.md。
• 用户明确偏好、环境偏好、验证偏好写入 code-copilot/memory/preferences.md。
• code-copilot/knowledge/ 只保留专题知识材料，不再承载上述三类会话记忆。

4. Agent Prompt 同步

修改 code-copilot/agents/*.md 时，涉及启动上下文、知识沉淀、验证前置读取的描述，都必须指向 code-copilot/memory/decisions.md、code-copilot/memory/pitfalls.md、code-copilot/memory/preferences.md。