From ec2f74bf189f4a58bba26a76bb83fc39bb8473d0 Mon Sep 17 00:00:00 2001 From: cat-shark <1716967236@qq.com> Date: Wed, 18 Nov 2026 15:01:18 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=8E=A5=E5=85=A5=E5=85=B1=E6=9C=89?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E4=B8=8E=E7=AC=94=E8=AE=B0=E6=A0=A1=E9=AA=8C?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=EF=BC=8C=E8=AF=B4=E6=98=8E=20.agents=20?= =?UTF-8?q?=E5=8F=AA=E6=94=BE=E6=9C=AC=E4=BB=93=E7=8B=AC=E6=9C=89=E5=86=85?= =?UTF-8?q?=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) 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