docs: 接入共有技能与笔记校验入口,说明 .agents 只放本仓独有内容

This commit is contained in:
2026-11-18 15:01:18 +08:00
parent 27ddf8be5a
commit ec2f74bf18
+23
View File
@@ -16,6 +16,29 @@
(结构由产出方保证、LLM 输出在调用模型的那侧校验、接收方只做映射) (结构由产出方保证、LLM 输出在调用模型的那侧校验、接收方只做映射)
- 本仓库专属技能:`.agents/skills/`(如 `comment-cleanup`);决策笔记:`.agents/notes/`(见下节「重要改动必须留笔记」) - 本仓库专属技能:`.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 - Java 17