diff --git a/AGENTS.md b/AGENTS.md index 0289e26..e5724ab 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,29 @@ (结构由产出方保证、LLM 输出在调用模型的那侧校验、接收方只做映射) - 本仓库专属技能:`.agents/skills/`(如 `comment-cleanup`);决策笔记:`.agents/notes/`(见下节「重要改动必须留笔记」) +> **本仓库的 `.agents/` 只放 lpt-be 独有的东西**(上述专属规则、`comment-cleanup`、本仓笔记)。 +> 共有技能(`write-notes-like-deepseek`、`mermaid-diagram`)只在 meta 的 `.agents/skills/`,本仓库不放副本。 +> agent 在 meta 根目录运行,改动本仓库用 `subagent(cwd=lpt-be)`;详见 meta `AGENTS.md`。 + +## 重要改动必须留笔记 + +规则来源:meta 仓库 `.agents/skills/write-notes-like-deepseek/SKILL.md`(动手前先读它,本文件只列接入约定)。 + +1. **非平凡改动先立笔记**:改了行为、架构、跨文件契约、流程与工具链、测试策略、落盘/网络/配置格式, + 或写了会被以后重新审视的取舍,就在 `.agents/notes/` 下写或更新一篇;纯机械改(样式、格式化、打标、 + 不改行为的依赖补丁、常规 CRUD)直接提交,不要为了留痕而留痕。 +2. **先检索再动手**:`rg --hidden --glob '!.agents/notes/archived/**' "<机制名或关键词>" .agents/notes/`, + 有归属就**就地更新那篇**(路径、类名、默认值等事实直接改);决定翻转则新开一篇并互链,禁止把 + `## Decision` 改成反面。 +3. **生命周期**:动手前写 `proposed/`;落地后移到 `implemented/` 并改成现在时;方案被否决且能防重犯写 + `rejected/`;彻底被取代才归档。路径格式 `{proposed|implemented|rejected}/{feature|bug-fix|simplification|architecture|process|testing}/yyyy-mm-dd-主题.md`。 +4. **备选方案先写对方最强理由再否决**;真实没考虑过备选就写「无」,不要编造凑数。 +5. **提交前跑校验**(在 meta 根目录,无 git hook,靠自觉): + ```sh + node .agents/scripts/verify-notes.ts lpt-be + ``` + 未接 CI 强制门,红了先修再交。 + ## 技术栈 - Java 17