1.5 KiB
1.5 KiB
工作区资产归属
- 功能:规定各类文档与产物放在哪个仓库/目录,避免重复、错位与正文复制。
- 何时用:新增或修改文档时;决定某段说明该写进哪个仓库时;处理优化清单时;判断某个文件是否该出现在 meta 仓库时;放规则或技能时。
规则
文档归属
- 所有系统文档统一在
lpt-docs仓库维护,代码仓库不保留 README、docs/等文档文件。 lpt-docs只维护系统概念描述和设计思路,不保存开发记录、系统中间态和开发过程产物。- 跨仓库的实现优化清单记录在 meta 仓库
OPTIMIZATION_BACKLOG.md(只放待办、依据与验收标准);概念与设计仍归lpt-docs。 - 修改
lpt-docs后,如需在 meta 仓库补充说明,保持 meta 仓库不复制文档正文。
meta 仓库的维护边界
- 本 meta 仓库只维护
AGENTS.md、.gitignore、.agents/(代理技能与通用规则)和docs/diagrams/(图表评审产物),不要在本仓库根目录创建业务代码或系统文档。 .gitignore忽略所有子项目目录,只放行上述根级条目,避免把独立 Git 仓库提交进本 meta 仓库。
规则与技能的落位
- 通用规则(跨仓库)→ meta 仓库
.agents/roles/。 - 项目专属规则 → 该仓库自己的
roles/。 - 工作区级技能 →
.agents/skills/<技能名>/;子项目专属技能 → 该仓库skills/。