Why: PR test evidence depended on the agent's word (single point); the running binary could not answer what combination it was built from; and irreversible operations lacked an explicit agent-stops-here boundary. Evidence: Gitea runner online (home-runner, ubuntu-latest+docker); make version prints describe+component SHAs; two-key line maps to baseline hard boundary 1. CI first run observed on this PR before merge (see Actions tab). Impact: .gitea/workflows/ci.yaml runs make test + make build on PR/push; Makefile injects main.version (make version / agent-system version); AGENTS.md and adoption register the two-key rule. No product code change. Refs: policy/adoption.md; release-operations requirements
2.8 KiB
2.8 KiB
通用规范采纳记录(Agent-System-Dev 组合)
- 项目/负责人:Agent-System 组合 / weichen
- 状态:active(2026-09-30 经 PR weichen/Development-Guidelines#1 采纳 draft.7;机制经 Dev PR#1 合入 ef89fc8)
- 规范位置:deps/development-guidelines(gitlink 固定版本)
- 过程文档位置:modules/documents(docs/records/)
- 版本权威:父仓 gitlink
- 批准/生效依据:Dev PR#1(19/19 正负例 + make test);guidelines PR#1
| 规范/工作流 | 适用条件与范围 | 执行方式/证据 |
|---|---|---|
| core/baseline.md | 日常 | manual |
| workflows/delivery.md(含启动自检 §1) | 交付 | advisory(make precheck);判定输出 BUSY/SYNC 时阻断 |
| standards/collaboration.md | 并行/同步节点 | enforced(本地):pre-commit 拒绝集成分支直提与坏分支名(负例:hook-main/badbranch 拒绝输出);节点同步由 task-sync 落卡 |
| 提交格式(主题行/四段 body) | 全部提交 | enforced(本地):commit-msg 拒绝 >100 列与句点结尾(负例:longsubject 拒绝输出);受保护分支经 Gitea PR 合入(本记录 3 个 PR 为正例) |
| standards/verification.md | 验收 | manual:make test(12 ok 行)+ scratch 19/19 为证 |
| standards/multi-repo.md | 跨仓/gitlink | manual;受控历史迁移通道已于 2026-09-30 行使一次(documents/records/2026-09-30-history-migration.md) |
| 工作区回收 | 交付终点 | advisory(task-finish);负例:合入前 finish 拒绝输出 |
| standards/tool-adaptation.md(draft.8) | 为工具创建规则/钩子实例 | 本组合 CLI/git 级实例已登记:policy/tool-adaptation-matrix.md(A1–A7 逐行定级+正负例证据) |
| 同上(zcode 实例) | zcode 客户端写路径 | policy/tool-adaptation-zcode.md:PreToolUse 写守卫(.zcode/config.json + scripts/zcode/write-guard.sh),A1/A3 落笔前 enforced |
| core/baseline.md「规范层级」+ documentation.md「记忆分层/机制化」(draft.9) | 层级效力、记忆权威、经验机制化 | manual:本仓 policy/ 仅收紧不放宽;记忆四层按条文执行(任务卡=任务记忆,documents/records=项目记忆,Dev 仓 AGENTS.md 指针已就位) |
项目差异
| 原规则/章节 | 项目采用方式 | 原因与风险 | 负责人/复查条件 |
|---|---|---|---|
| baseline 硬边界 1(授权范围) | 高后果双钥匙:改写历史/解除分支保护/删归档/发布——Agent 只准备,用户执行(AGENTS.md 条文) | 单人+Agent 场景下消除单点;风险=用户不在场时高后果操作排队 | weichen;首次触发时复查 |
- Gitea 分支保护已启用(2026-09-30):11 个组合仓 main 禁直推、拒绝陈旧候选;负例:直推被 pre-receive hook declined。平台层 A3 升级为 enforced。