Adopt the task-startup gate and commit format in AGENTS.md
ci / vet-and-test (pull_request) Successful in 2s
ci / docker-checkout-hostgateway (pull_request) Successful in 2s

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
This commit is contained in:
weichen
2026-09-30 03:14:39 +00:00
parent dbeed2f1b6
commit fa7d606c71
+14 -22
View File
@@ -1,27 +1,19 @@
# 项目工作入口
# Agent 工作说明(Error-Code-System)
本项目采纳的通用规则:[核心规则](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/standards/observability.md)。
- 其他专题:按 [任务索引](deps/development-guidelines/README.md) 选择。
## 任务启动门禁
项目补充硬边界:
- 任务启动或恢复后,第一次写操作前在 Dev 仓运行 `make precheck` 并附完整输出(本仓作为子仓随父仓编排);
本仓独立开发时核对工作树 clean、与权威 origin/main 同步,并按任务触发读对应专题。
- 从权威 origin/main 固定共同起点 R0,建 feature|fix|hotfix/<slug> 分支(Dev 仓 `make task-start` 自动化);
任务中途不重复 precheck。
- 验收、请求审核、合入前各同步一次最新目标分支并附证据;合入后回收任务工作区与已合入分支。
- 提交主题行:英文祈使句一行(≤100 列,不以句点结尾);body 写 `Why: / Evidence: / Impact: / Refs:`。
- 规范码以本仓 `errcode` 与 `domains` 为权威。消费方不得另起一套同义字符串。
- 未知码回落 `sys.unknown_code`,HTTP 500,禁止当成功,禁止无条件重放。
- 副作用为 `possible` 或 `unknown` 的码不得无条件重放。
- 本仓不导入 Agent-Native、Agent-Squad 或 Logging-System。
## 仓内规则
任务权威:Gitea 仓库 `weichen/Error-Code-System` 的 Issue 与 Pull Request。
规范性文档目录与过程记录位置:`policy/`;过程记录豁免目录 `docs/records/`。
默认集成基线和提交身份:`main`。权威远端 `ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Error-Code-System.git`。
共享环境/发布入口及授权:查询服务默认 `:8091`,仅本地组合根,无共享环境。
- 模块边界、公开契约与隔离档位见 `policy/modules/`(如有)与 PROJECT.md。
- 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进;受保护分支经 PR 合入。
- 验证命令见 PROJECT.md「验证」节;完成声明须附实际命令输出证据。