新增项目文档规范驱动并对齐log，后续还可以把pitfall和anti pitfall都关联起来形成自动纠错

AGENTS.md

@@ -115,14 +115,33 @@ Agent 在以下场景中应自动检索 `.opencode/data/pitfalls/pitfalls.md`：
 每次完成涉及 debug/修复的任务后，应加载 `pitfall-journal` Skill 并执行写入流程。
 判断标准：问题根因是否"非显而易见"——如果只看代码逻辑觉得应该没问题但运行时报错，就值得记录。
 
+## 架构方案沉淀
+
+项目根 `docs/` 目录集中存放架构方案、技术规范、项目约定等规范文档。
+
+### 执行前检查（Pre-execution Check）
+
+当 Agent 识别到当前任务涉及以下维度时，应在**执行代码改动前**加载 `spec-docs` Skill 并执行操作 A（检查是否需要创建/更新规范文档）：
+
+**触发关键词**（任一命中即触发）：
+- 架构：`架构`、`重构`、`分层`、`模块划分`、`技术选型`、`目录结构`、`核心依赖`
+- 方案：`设计方案`、`设计系统`、`交互规范`、`UI规范`、`界面风格`、`数据流`、`API设计`、`部署方案`
+- 规范：`项目规范`、`编码规范`、`命名规范`、`约定`、`标准`、`编码风格`、`工作流`
+
+不触发的情况：纯 bug 修复、单文件小改动、临时实验代码、纯数据文件变更。
+
+### 周期审查
+
+每 7 天或每 30 条新 changelog 后，Agent 自动根据 changelog 对 `docs/` 下文档进行一致性审查（`spec-docs` Skill 操作 B），报告遗漏/陈旧/互斥项。changelog 不可信——发现互斥时优先通过检索实际代码验证。
+
 ## 任务完成 Checklist（强制）
 
 Agent 在即将输出最终回复前，必须逐项检查。跳过任何一项视为执行错误。
 
 ### A. 画像信号扫描（短路版）
 扫描本次对话中用户消息，检查是否出现以下触发词族：
-- 个人偏好：`我喜欢` / `我倾向` / `我不喜欢` / `以后都` / `我的风格` / `太花哨` / `简洁` / `精炼` / `啰嗦`
-- 项目决策：`这个项目是` / `目标用户是` / `技术栈` / `架构上` / `产品方向` / `定位是`
+- 个人偏好：`我喜欢` / `我倾向` / `我不喜欢` / `我讨厌` / `我习惯` / `我偏好` / `以后都` / `倾向于` / `我的风格` / `太花哨` / `花里胡哨` / `看着舒服` / `简洁` / `精炼` / `轻量` / `啰嗦` / `信奉`
+- 项目决策：`这个项目是` / `目标用户是` / `这个应用的` / `我们的用户` / `技术栈` / `架构上` / `产品方向` / `产品形态` / `定位是` / `使用场景` / `面向` / `核心竞争力` / `路线图` / `长期来看` / `最终形态`
 
 无匹配 → 跳过（thinking 应在 50 token 内结束）。有匹配 → 加载 `profile-memory` Skill 执行记录流程。
 
@@ -142,6 +161,10 @@ Agent 在即将输出最终回复前，必须逐项检查。跳过任何一项
 4. **本次是否有 Skill 使用异常？**（遗漏、误触、产物与预期偏差）
    - 是 → 执行 `epee-orchestrator` Skill 的自迭代确认流程
 
+5. **本次改动是否涉及架构/规范/方案？**
+   - 检查 `docs/` 下相关文档是否需要创建或同步更新
+   - 需要但尚未写入 → 加载 `spec-docs` Skill 执行操作 C 写入/更新
+
 ### C. 收尾
 先完成 checklist 中的所有写入动作，再输出面向用户的回复文本。
 如执行了 B2 项（开发日志写入），在回复末尾附 `[已记录到开发日志]`。