docs: 新增说人话与图示优先两条规则,登记跨仓库笔记

This commit is contained in:
cat-shark
2026-11-20 09:36:54 +08:00
parent 84ce312e4b
commit 281585698b
7 changed files with 241 additions and 4 deletions
+9 -4
View File
@@ -24,8 +24,10 @@
- **通用规则(跨仓库)**:`.agents/roles/`
- `todo-discipline.md` 待办收口 · `parallel-and-delegation.md` 并行与委派 · `commit-convention.md` 提交规范
- `visual-communication.md` 图示优先(**强制**:布局、流程、结构一律用截图 / SVG / Mermaid 表达,禁止在回复里用等宽字符拼框图)
- `subagent-execution.md` 多部分改动交给子代理、主代理只复核 · `research-and-reporting.md` 调研与问题定位 · `shell-environment.md` Windows/PowerShell · `workspace-layout.md` 资产归属 · `repo-operations.md` 跨仓库 Git 操作
- `dev-unblock-and-escalation.md` 开发环境自解锁与求助阈值 · `service-boundaries-and-validation.md` 校验写在哪一层、拒绝重复防御
- `plain-language.md` 说人话(**强制**:回答「是什么 / 缺什么 / 怎么改」先给具体对象与取值,再决定要不要统称;颜色、间距、圆角这类就叫「取值」,不拿 token、设计令牌、体系、机制等行话包装;一句话最多一层抽象)
- `business-terminology.md` 业务名词收敛(**强制**:agent 之间交流系统概念只用 `lpt-docs/docs/concepts/README.md` 术语表里的名称,不自造同义词;表里没有的词先补表再用。代码标识符也由术语表的英文名派生,不为具体位置另起名字)
- **共有技能(唯一来源,只在 meta)**:`.agents/skills/<技能名>/`
- `write-notes-like-deepseek/` 非平凡改动留决策笔记(笔记契约 + 三条校验脚本)
@@ -70,16 +72,19 @@ AGENT_NOTE_ROOT=$PWD/lpt-be/.agents/notes node .agents/skills/write-notes-like-d
> 本索引只列**子项目独有**的规则与技能;共有技能在 meta `.agents/skills/`,全仓通用,见上节。
- **lpt-fe**(`lpt-fe/AGENTS.md`)
- 规则(`lpt-fe/.agents/roles/`):`design-principles.md` 新增或重构页面 · `design-system.md` 取值与调性 · `code-standards.md` 写组件与请求层 · `ui-review-checklist.md` 交付自检 · `testing.md` 写测试 · `style-conventions.md` 样式与交互
- 技能(`lpt-fe/.agents/skills/`):`ui-review` 新页面或大范围 UI 改动
- 规则(`lpt-fe/.agents/roles/`):`design-principles.md` 新增或重构页面 · `design-system.md` 取值与调性 · `responsive.md` 窄屏与断点 · `code-standards.md` 写组件与请求层 · `ui-review-checklist.md` 交付自检 · `testing.md` 写测试 · `style-conventions.md` 样式与交互
- 技能(`lpt-fe/.agents/skills/`):`ui-review` 新页面或大范围 UI 改动 · `rule-fixture` 看当前规则下会设计成什么样(改规则前后各跑一次,人工判规则缺口)
- **lpt-be**(`lpt-be/AGENTS.md`)
- 规则(`lpt-be/.agents/roles/`):`database-migration.md` 数据库迁移 · `data-access.md` 数据访问层 · `api-response.md` 响应与 DTO · `ownership-and-markers.md` 内容归属与标记 · `ai-integration.md` AI 异步链路
- 规则(`lpt-be/.agents/roles/`):`database-migration.md` 数据库迁移 · `data-access.md` 数据访问层 · `api-response.md` 响应与 DTO · `ownership-and-markers.md` 内容归属与标记 · `ai-integration.md` AI 异步链路 · `code-standards.md` 代码规范与 Checkstyle 门禁 · `code-review-checklist.md` 工具查不了的评审项
- 技能(`lpt-be/.agents/skills/`):`comment-cleanup` 注释清理
- **lpt-ai**(`lpt-ai/AGENTS.md`)
- 规则(`lpt-ai/.agents/roles/`):`task-queue.md` 队列契约 · `security-and-degradation.md` 安全边界与降级
- **lpt-docs**(`lpt-docs/AGENTS.md`):规则(`lpt-docs/.agents/roles/`):`documentation-scope.md` 文档边界
- 业务名词的唯一权威是 `lpt-docs/docs/concepts/README.md` 术语表;交流用词约束见 `business-terminology.md`
- **lpt-android / lpt-infra / lpt-companion**:暂无专属规则与技能,按各自 `AGENTS.md` 执行
- **lpt-android**(`lpt-android/AGENTS.md`)
- 规则(`lpt-android/.agents/roles/`):`design-principles.md` 写码前设计计划与页面结构取舍 · `design-system.md` 颜色间距圆角文字与按钮状态取值 · `code-standards.md` Compose 写法与请求层 · `ui-review-checklist.md` 快检与交付自检 · `testing.md` 测试分层与真机验证矩阵
- 技能(`lpt-android/.agents/skills/`):`ui-review` 新页面或整页改版的真机截图评审
- **lpt-infra / lpt-companion**:暂无专属规则与技能,按各自 `AGENTS.md` 执行
> 索引只写路径与触发场景,不复制正文。新增或删除子仓库规则/技能时同步本节,约束见 `.agents/roles/workspace-layout.md`。
> 共有技能不进本节:它们只在 `.agents/skills/`,所有仓库通用,不需要逐仓登记。