diff --git a/PROJECT.md b/PROJECT.md index 081b9ad..1787793 100644 --- a/PROJECT.md +++ b/PROJECT.md @@ -12,8 +12,8 @@ - 提交/审核/合并/发布身份与权限:仓库所有者 weichen。 - 任务唯一来源:Gitea `weichen/Logging-System` 的 Issue 与 Pull Request。 - 规范性文档目录:`policy/`。 -- 过程文档仓/目录:`docs/records/`(项目内豁免)。 -- 交接记录位置:随任务主记录;需要落盘的交接放入 `docs/records/`。 +- 过程文档仓/目录:`.task/`(任务卡与交付流程证据);`docs/records/`(其他过程记录,项目内豁免)。 +- 交接记录位置:随任务主记录;需要落盘的交接放入 `docs/records/`(其他过程记录);任务卡与证据在 `.task/`。 - 凭证查找入口及所需字段:采集 token 来自服务配置或环境,字段名为 token / `X-Log-Token`,值不入库。进程内日志还可由 `LOGSYS_CONFIG`、`LOGSYS_LEVEL`、`LOGSYS_SERVICE`、`LOGSYS_REDACT` 覆盖。 ## 依赖组合 diff --git a/policy/guidelines-adoption.md b/policy/guidelines-adoption.md index 9414fd6..33633a0 100644 --- a/policy/guidelines-adoption.md +++ b/policy/guidelines-adoption.md @@ -4,7 +4,7 @@ - 状态:active - 规范位置:`deps/development-guidelines` - 规范性文档目录:`policy/`(项目规则与制度放此处) -- 过程文档位置:`.task/`(任务卡,随 PR 维护);任务主记录在 Gitea PR;`docs/records/`(项目内固定目录豁免,方案与验证记录) +- 过程文档位置:`.task/`(任务卡与交付流程证据,随 PR 维护);`docs/records/`(其他过程记录,项目内固定目录豁免,方案与验证记录);任务主记录在 Gitea PR - 版本权威:本仓 gitlink `deps/development-guidelines` @ `2688fd2be6a5`(完整 SHA `2688fd2be6a52c0bf110e7e6366b6f291ab5e4eb`,内容版本 `0.1.0-draft.12`);无可读发布标签;治理工具 gitlink `deps/development-manager` @ `bd3a7de57a3a`(完整 SHA `bd3a7de57a3a9e1a4495b94c5fa5c08d71e7be8c`) - 批准/生效依据:`feature/governance-adoption PR(Logging-System)`;合入前须在 `.task/feature-governance-adoption.md` 记录正负例、Review 与 CI 结果 - 替代范围和迁移说明:本次把 Guidelines gitlink 从 `26b562d2e34f`(`0.1.0-draft.6`)升级到 `2688fd2be6a5`,并接入共享治理套件(`scripts/dm`、`scripts/agent-exec`、`scripts/task`、`scripts/hooks/pre-commit`、`.gitea/workflows/governance.yml`)。无旧 Agent 执行器需要替代。 @@ -24,7 +24,7 @@ | standards/documentation.md | 三层文档 | `docs/` 与 `docs/records/` 分开;任务过程记录按 `.task/` 与 PR | manual | | standards/multi-repo.md | 被 submodule 消费;示例模块用相对 replace | 主模块不嵌套错误码库 | manual | | standards/data-reliability.md | JSONL 采集文件 | 无事务数据库;文件是日志投影 | manual | -| standards/agent-execution.md | 工程 Agent 执行(实施、修复、测试、审阅) | 配置见 AGENT-EXECUTION.md;入口 `scripts/agent-exec`(validate / admit);CI `governance` 工作流运行 validate 与 governance check;本地 admit 待 host 启用 `core.hooksPath` 后生效 | enforced(CI)+ advisory(本地);证据:`governance check + 正负例(.task/feature-governance-adoption.md)` | +| standards/agent-execution.md | 工程 Agent 执行(实施、修复、测试、审阅) | 配置见 AGENT-EXECUTION.md;入口 `scripts/agent-exec`(validate / admit);CI `governance` 工作流运行 validate 与 governance check;本地 admit 待 host 启用 `core.hooksPath` 后生效 | advisory(CI;分支保护尚未设为必需检查,设为必需检查并有阻断负例后再登记 enforced)+ advisory(本地);证据:`governance check + 正负例(.task/feature-governance-adoption.md)` | | standards/testability.md、workflows/design-verification.md | 功能增量的设计与可测试性 | 跨包变更按增量写明验收与测试范围 | manual | | standards/release-operations.md | 无制品流水线 | 消费方固定 gitlink | 不适用 | | workflows/automation.md | 无独立定时任务 | 异步批导出是库行为,不是运营自动化 | 不适用 | @@ -34,6 +34,7 @@ | 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 | |---|---|---|---| | documentation.md 过程仓默认独立仓库 | `docs/records/` 豁免 | 个人项目。风险同其他三仓 | 采集服务对外长期运行时复查 | +| documentation.md 过程仓默认独立仓库 | `.task/` 仓内任务卡与交付证据目录 | 个人项目,任务卡随 PR 维护。风险同其他三仓 | 采集服务对外长期运行时复查 | ## 本次升级或首次接入验证