docs: 规则与技能迁入 .agents/,并接入决策笔记

- roles/ 与 skills/ 迁移到 .agents/ 下,AGENTS.md 引用同步
- 收录 8 篇决策笔记到 .agents/notes/
- .rgignore 排除 archived 历史快照
This commit is contained in:
2026-11-18 15:01:05 +08:00
parent eb3da2e74a
commit 27ddf8be5a
17 changed files with 369 additions and 7 deletions
+10 -7
View File
@@ -5,13 +5,16 @@
## 规则与技能位置
- 通用规则(跨仓库):meta 仓库 `.agents/roles/`(本仓库的 Git 提交规范也统一在其中的 `commit-convention.md`,本文件不再重复)
- 本仓库专属规则:`roles/`
- `roles/database-migration.md`:数据库迁移(Flyway Migration)
- `roles/data-access.md`:编码规范 · 数据访问层
- `roles/api-response.md`:响应规范、DTO 转换
- `roles/ownership-and-markers.md`:内容归属与结构化报告(归属-01 / 报告-01)、标记(标记-01)
- `roles/ai-integration.md`:学习引导(复习-06)、AI 异步链路(AI-02)
- 本仓库专属技能:`skills/`(如 `comment-cleanup`)
- 命名:业务概念的英文名以 `lpt-docs/docs/concepts/README.md` 术语表为准,库表、实体、DTO 字段由它派生,不另起别名(规则见 meta `.agents/roles/business-terminology.md`)。
- 本仓库专属规则:`.agents/roles/`
- `.agents/roles/database-migration.md`:数据库迁移(Flyway Migration)
- `.agents/roles/data-access.md`:编码规范 · 数据访问层
- `.agents/roles/api-response.md`:响应规范、DTO 转换
- `.agents/roles/ownership-and-markers.md`:内容归属与结构化报告(归属-01 / 报告-01)、标记(标记-01)
- `.agents/roles/ai-integration.md`:学习引导(复习-06)、AI 异步链路(AI-02)
- 跨服务校验归属:不写在本仓库,统一按 meta 仓库 `.agents/roles/service-boundaries-and-validation.md`
(结构由产出方保证、LLM 输出在调用模型的那侧校验、接收方只做映射)
- 本仓库专属技能:`.agents/skills/`(如 `comment-cleanup`);决策笔记:`.agents/notes/`(见下节「重要改动必须留笔记」)
## 技术栈