From 9b77bf4d6d83d8a6dbf62e4a71f869729b635414 Mon Sep 17 00:00:00 2001 From: weichen Date: Wed, 30 Sep 2026 03:14:37 +0000 Subject: [PATCH] Adopt the task-startup gate and commit format in AGENTS.md Why: the composition adopted the delivery gate (Dev repo ef89fc8); resident entry rules must carry the gate so agents load them without reading the guidelines submodule first. Evidence: text-only entry change; gate mechanics validated in the Dev repo scratch-repo suite (19/19) and merged as PR weichen/Agent-System-Dev#1. Impact: entry doc only; no code, contract, or build change in this repo. Refs: Development-Guidelines 0.1.0-draft.7; Agent-System-Dev ef89fc8 --- AGENTS.md | 39 ++++++++++++++------------------------- 1 file changed, 14 insertions(+), 25 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 562c326..c9e3279 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,30 +1,19 @@ -# 项目工作入口 +# Agent 工作说明（Agent-Native） -本项目采纳的通用规则：[核心规则](deps/development-guidelines/core/baseline.md)。 -采纳范围、生效状态及项目差异：[采纳记录](policy/guidelines-adoption.md)。 -项目事实、测试和环境入口：[PROJECT.md](PROJECT.md)。 +本仓开发遵循 Development-Guidelines（Dev 仓 `deps/development-guidelines`，gitlink 固定版本）： +核心规则见其 `core/`，按任务触发阅读 `standards/` 专题；日常交付走 `workflows/delivery.md`。 -- 启动：阅读以上短入口；只加载本次任务触发的专题。 -- 普通交付：[交付流程](deps/development-guidelines/workflows/delivery.md)。 -- 并行开发/正式测试/审核/合入：[共同基线与同步节点](deps/development-guidelines/standards/collaboration.md)，必须确认并实际同步最新权威目标。 -- Bug/异常：[系统性排障](deps/development-guidelines/workflows/debugging.md)。 -- 会话结束/换机器/换客户端/换执行者：[会话、执行者与机器交接](deps/development-guidelines/workflows/handoff.md)，状态写入任务主记录，不依赖本地会话历史。 -- 测试与验收：[验证标准](deps/development-guidelines/standards/verification.md)。 -- 模块/接口：[模块契约](deps/development-guidelines/standards/module-contracts.md)。 -- 功能设计/跨模块变更：[设计与验证](deps/development-guidelines/workflows/design-verification.md)，按增量明确验收、独立测试及故障范围。 -- 错误与过程事件：[可观测性](deps/development-guidelines/standards/observability.md)。 -- 拆仓与 submodule：[多仓库与固定版本组合](deps/development-guidelines/standards/multi-repo.md)。 -- 其他专题：按 [任务索引](deps/development-guidelines/README.md) 选择。 +## 任务启动门禁 -项目补充硬边界： +- 任务启动或恢复后，第一次写操作前在 Dev 仓运行 `make precheck` 并附完整输出（本仓作为子仓随父仓编排）； + 本仓独立开发时核对工作树 clean、与权威 origin/main 同步，并按任务触发读对应专题。 +- 从权威 origin/main 固定共同起点 R0，建 feature|fix|hotfix/ 分支（Dev 仓 `make task-start` 自动化）； + 任务中途不重复 precheck。 +- 验收、请求审核、合入前各同步一次最新目标分支并附证据；合入后回收任务工作区与已合入分支。 +- 提交主题行：英文祈使句一行（≤100 列，不以句点结尾）；body 写 `Why: / Evidence: / Impact: / Refs:`。 -- `contract` 不依赖内核、产品类型、数据库或本仓以外的运行时；错误码字符串与 Error-Code-System 的 `agent.*` 规范码对齐，旧字符串只作为别名由错误码库解析。 -- 未知结果保持 Unknown，不降级为成功或失败；副作用为 possible/unknown 时禁止无条件重放。 -- 缺能力即拒绝，不静默降级到 Stub。Workspace 路径授权不是 OS 沙箱。 -- 意图闸门为可选依赖：唯 `adapters/intentgate` 与其测试可 import agent-intent；contract/exec/runtime 等核心不感知意图。未 Wrap 或意图快照为空时，后端行为与原实现一致；识别系统错误 fail-closed。 -- 依赖仓版本以本仓 gitlink 为准，不执行 `submodule update --remote`。 +## 仓内规则 -任务权威：Gitea 仓库 `weichen/Agent-Native` 的 Issue 与 Pull Request。 -规范性文档目录与过程记录位置：`policy/` 放项目规则；`docs/records/` 为过程记录豁免目录（方案、验证、交接）。项目规范与过程记录不进通用规范库。 -默认集成基线和提交身份：`main`；提交身份沿用本机 git 作者，不在文档中写死密钥或个人 fork URL。 -共享环境/发布入口及授权：无共享运行环境。权威远端 `ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Native.git`。 +- 模块边界、公开契约与隔离档位见 `policy/modules/`（如有）与 PROJECT.md。 +- 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进；受保护分支经 PR 合入。 +- 验证命令见 PROJECT.md「验证」节；完成声明须附实际命令输出证据。