weichen
acd34769bf
Why: the Gitea server moved to https://gitea.naitangbaobao.cn with SSH on port 52222; endpoint references must follow or superproject CI checkout refuses the old URLs. Evidence: host-verified API reach and SSH auth (Dev task card fix/gitea-endpoint-migration) Impact: configuration only; no runtime behavior change. Refs: Dev PR #706
3.4 KiB
3.4 KiB
Agent 工作说明（Error-Code-System）
本仓开发遵循 Development-Guidelines（Dev 仓 deps/development-guidelines，gitlink 固定版本）：
核心规则见其 core/，按任务触发阅读 standards/ 专题；日常交付走 workflows/delivery.md。
任务启动门禁
- 任务启动或恢复后，第一次写操作前在 Dev 仓运行
make precheck并附完整输出（本仓作为子仓随父仓编排）； 本仓独立开发时核对工作树 clean、与权威 origin/main 同步，并按任务触发读对应专题。 - 从权威 origin/main 固定共同起点 R0，建 feature|fix|hotfix/ 分支（Dev 仓
make task-start自动化）； 任务中途不重复 precheck。 - 验收、请求审核、合入前各同步一次最新目标分支并附证据；合入后回收任务工作区与已合入分支。
- 提交主题行：英文祈使句一行（≤100 列，不以句点结尾）；body 写
Why: / Evidence: / Impact: / Refs:。
仓内规则
- 模块边界、公开契约与隔离档位见
policy/modules/（如有）与 PROJECT.md。 - 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进；受保护分支经 PR 合入。
- 验证命令见 PROJECT.md「验证」节；完成声明须附实际命令输出证据。
Gitea 与 Git 访问事实（2026-09-30 实测）
历史文档与旧链接里的 git-panel.u1680832.nyat.app:30319 已失效（TLS 握手失败），
见到一律按过期处理，不要再试。当前权威通道：
- Web / API（HTTPS）：
https://gitea.naitangbaobao.cn（Gitea 1.27.3， API 前缀/api/v1；偶发 broken pipe / 超时，重试即可）。 - Git over SSH：
ssh://git@gitea.naitangbaobao.cn:52222/weichen/<Repo>.git（各仓 origin 与 gitlink 均为此格式）。 - API token：
~/.secrets/gitea，两行键值URL_PREFIX=…与ACCESS_TOKEN=<40 位 hex>；取值grep ACCESS_TOKEN ~/.secrets/gitea | cut -d= -f2-， 用作Authorization: token <值>请求头。token 值不入仓、不回显、不写进产出物 （baseline 硬边界 2：只记录来源、字段与可用状态）。 - SSH key：
~/.ssh/home_gitea（ED25519，公钥指纹SHA256:GYXaOXIMeloQ1fKSfdJ/ndgPQzs/Ix7Hk62ekfkfQ20，Gitea 侧密钥名 GMKtec）；~/.ssh/config已有gitea.naitangbaobao.cn（端口 52222）主机条目，克隆/推送直接可用。
Agent 执行与新项目准入（强制）
- 缺 Guidelines 固定版本（
deps/development-guidelinesgitlink 未就绪或 HEAD 不符）时，Agent 只能只读分析，不得实施。 - 缺有效
AGENT-EXECUTION.md（scripts/dm governance check未通过）时禁止 AI 实施。 - 缺共享执行器（
scripts/agent-exec或deps/development-manager不可用）时，状态为blocked/unavailable，不得改由 host 替代。 - 不允许 host 代写实施单元；实施、修复与测试必须经
AGENT-EXECUTION.md登记的候选执行。 - 人类直接开发按其自身授权与项目规则进行，不受本条款约束。
- 分支保护与规范 tag 由用户负责设置与维护，Agent 不得代为设置。
入口：
- 需求分流：
scripts/task triage discover|decide|verify - 任务启动：
scripts/task start … - PR 检查：
scripts/task pr-check … - Agent 执行：
scripts/agent-exec run|apply|admit|validate
AI 实施单元只能经 scripts/agent-exec run 运行（遵循 AGENT-EXECUTION.md），并经 scripts/agent-exec apply 集成。