Details (original message): Initialize the repository with pinned submodules, project entry documents, and the design record.
4.1 KiB
4.1 KiB
通用规范采纳记录
- 项目/负责人:Agent-Intent / 仓库所有者 weichen
- 状态:active
- 规范位置:
deps/development-guidelines - 规范性文档目录:
policy/ - 过程文档位置:
docs/records/(项目内固定目录豁免。当前为个人维护的基础库,单独过程仓会让每份记录都变成跨仓 gitlink;任务主记录仍在 Gitea Issue/PR。豁免一经登记,过程记录不得再写入policy/或规范库。) - 版本权威:父仓 gitlink;可读标签:无(内容版本
0.1.0-draft.6,提交26b562d2e34fbc560711296a309c91c74ffc55b1) - 批准/生效依据:本仓接入提交;草案审阅完成后随该提交生效
- 替代范围和迁移说明:本仓为新建仓库,无既往规则需要迁移。
| 规范/工作流 | 适用条件与范围 | 采纳或不适用理由 | 执行方式/证据 |
|---|---|---|---|
| core/baseline.md | 日常工作 | 所有改动都要守硬边界 | manual |
| workflows/delivery.md、debugging.md、handoff.md | 交付、排障与交接 | 单人维护仍需要可交接的任务记录 | manual |
| standards/collaboration.md | 并行共同起点、节点同步与陈旧候选拒绝 | 本仓会被 Agent-Squad / Agent-Native 以 gitlink 消费 | manual |
| standards/verification.md | 验证与结论 | 仓库根 go vet / go test(含 -race) |
manual;命令见 PROJECT.md |
| workflows/design-verification.md、standards/testability.md、standards/failure-containment.md | 识别漏斗、配置合并与快照切换 | 识别必须可脱离外部 I/O 独立验证;配置失败保留上一快照 | manual |
| standards/module-contracts.md | intent/conformance/catalogcheck/examples 边界 | 公开端口按层拆分;扩展点只留接口 | manual |
| standards/observability.md | 错误码、识别事件日志 | 与 Error-Code-System / Logging-System 对齐 | manual |
| standards/configuration.md | spec/overlay 双源合并、快照 revision、生效时机与诊断 | 本仓核心就是配置驱动模块;check/explain 由 intentctl 承担 |
manual |
| standards/multi-repo.md | submodule 与固定组合 | 规范与基础库以 gitlink 锁定 | manual |
| standards/security.md | 凭证、配置信任边界 | 配置文件属宿主可信输入;本仓不含凭证 | manual |
| standards/documentation.md | 三层文档 | policy/ 与 docs/records/ 已分开 |
manual |
| standards/data-reliability.md | 本仓自有数据库 | 无数据库;快照替换的原子性由并发测试覆盖 | 不适用 |
| standards/agent-execution.md | Agent 执行契约 | 本仓不做执行,只做 LLM 前的确定性识别 | 不适用 |
| standards/release-operations.md | 独立发布流水线 | 当前无制品仓库与部署入口 | 不适用 |
| workflows/automation.md | 定时与后台任务 | 本仓无 daemon | 不适用 |
项目差异
| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| documentation.md 过程仓默认独立仓库 | 过程记录放 docs/records/ |
个人基础库;风险是记录与代码同 PR 时容易把证据写成第二权威。任务状态仍只认 Gitea Issue/PR | 出现第二名维护者或对外发布流程时复查 |
默认做法差异说明理由;硬边界冲突须有明确有效决策,不能用此表自授权。建议不采用无需登记。
本次升级或首次接入验证
- 入口:根
AGENTS.md、PROJECT.md指向deps/development-guidelines。 - 子模块:
deps/development-guidelines固定26b562d2e34fbc560711296a309c91c74ffc55b1;deps/error-code-system固定28fa06eaa56a19906732681cc02474a87ac9d408(含intent种子域);deps/logging-system固定2c5716fdcffbc4696fc0371afc70f39c44174201。三者与 Agent-Squad / Agent-Native 当前组合一致(error-code-system 为新增 intent 域后的新提交,属追加式变更)。 .gitmodules使用批准的上游 SSH URL,不含本机路径或凭证。- 执行方式保持 manual:挂载 Markdown 不自动改变 CI。
- 回退:恢复本提交之前的 gitlink,并删除根入口与
policy/guidelines-adoption.md中对应条款;无已生效的 CI 或权限变更需要另恢复。