docs: 接入共有技能与笔记校验入口,说明 .agents 只放本仓独有内容
This commit is contained in:
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user