From c35c1737161ea428c487c066cb39eba4923535d2 Mon Sep 17 00:00:00 2001 From: ila Date: Mon, 10 Aug 2026 19:01:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=A1=B9=E7=9B=AE=E6=A1=A3=E6=A1=88?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=AD=90=E9=A1=B9=E7=9B=AE=E4=B8=8E=E4=BA=A4?= =?UTF-8?q?=E4=BB=98=E5=8D=95=E5=85=83=20(#13)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Project-Profile.-.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Project-Profile.-.md b/Project-Profile.-.md index 22fb9d6..a637e5e 100644 --- a/Project-Profile.-.md +++ b/Project-Profile.-.md @@ -15,6 +15,18 @@ | 主要维护者 | `ila` | | 文档适用范围 | 默认分支当前版本；具体镜像 revision 见每个本地文件头 | +## 子项目与交付单元 + +“子项目”是仓库中具有明确职责和规则边界的应用或模块；“交付单元”是能够独立构建、测试、版本化或发布的程序、服务、库或文档包。一个子项目可以对应一个交付单元，也可以包含多个交付单元。 + +| 子项目 / 交付单元 | 职责 | 技术栈 | 构建与测试 | 版本与发布方式 | 规则入口 | 共享边界 | +|---|---|---|---|---|---|---| +| DevHarness 模板 | 提供 Agent 开发流程、Wiki 镜像和结构检查 | Markdown、Python 3 标准库、Gitea 1.25 | `python dev_scripts/check_harness.py --strict`；`python -m unittest discover -s tests -v` | 跟随仓库 `main` 分支，不单独发布产品程序 | 根目录 `AGENTS.md` | Gitea 工单、Wiki、Git 和 `docs/` 的事实来源边界 | + +单应用项目只填写一行。多应用单仓库必须逐个填写，并为技术栈、构建测试或安全规则不同的目录增加子目录 `AGENTS.md`。技术栈不同不等于必须拆分 Git 仓库；是否拆仓应根据团队、权限、发布周期、仓库效率、复用关系和共享接口稳定性判断。 + +跨子项目接口或契约必须指定唯一事实来源，并说明各交付单元的兼容范围和验证命令。不得在多个页面维护互不确认的“权威版本”。 + ## 技术栈与运行环境 | 部分 | 技术 | 规则文件 |