agent-bot
1409e02187
- AGENTS.md/PROJECT.md rewritten to three-layer model (hard/default/advice); remote authority = Gitea native protection, coding flow zero-agentctl - delete .cursor/rules/agentctl-mandatory.mdc; cursor hooks downgraded to advisory - CURRENT/FEATURE-MATRIX become read-only snapshots; task state = Issue/PR - CI: add tracked secrets scan to required go-vet job - closeout record with V19/V20/V23/V26 evidence - local pre-commit/reference-transaction hook files removed from main worktree
4.2 KiB
Agent-System 项目入口
工作边界见 AGENTS.md（Gitea 原生门禁模型）。本仓库是 Go + React/Vite + PostgreSQL/pgvector 的多用户工作流与对话平台，产品执行器为容器中的产品 PI Agent Runner。
仓库地图
| 路径 | 用途 |
|---|---|
cmd/、internal/ |
服务入口与 Go 模块 |
web/ |
React/Vite 前端 |
deploy/postgres/goose/ |
Goose 数据库迁移 |
configs/、templates/ |
运行配置、提示词与工作流模板（变更可能需要运行验收） |
scripts/ |
工程、环境与推送工具 |
.doc/ |
文档地图、任务与证据 |
data/dev、data/test、data/main |
各环境独立业务数据与工作区 |
模块编码/接口调整前读 模块开发标准，遵守既有接口、事件和表写者边界。
环境与操作入口
| 环境 | 分支 | Compose | HTTP | DB 端口 | 数据路径 |
|---|---|---|---|---|---|
| 开发 | dev | agent-dev | 8080 | 5433 | data/dev |
| 测试 | test | agent-test | 8081 | 5434 | data/test |
| 生产 | main | agent-main | 8000 | 5435 | data/main |
| 共享 KB | 跨环境 | agent-infra | - | 5432 | data/shared/kb |
这是拓扑约定，实际端口/制品/config/schema 由目标环境收据核实。知识库共享；对话、工作区、审计及业务 DB 严格隔离，禁止跨环境读写。
创建任务、合入、环境写操作与清理遵循 AGENTS.md 的 PR 模型：功能分支 → PR（必需 CI + 非作者批准）→ 合入；不再依赖本地治理工具链。旧 worktree 操作规范 保留为历史参考。只读环境查询入口为 ./scripts/env-service.sh all status；共享服务写操作在主运行入口执行。晋升到 test/main 单独授权。
验证入口
按 验证契约 选测试、精确用例、模型证据和报告层级。普通文档只做差异/链接/状态一致性；运行模板/提示词按运行内容验收。
- Go：
./scripts/arch-check.sh --mode block、go vet ./...、go test -short ./...；按范围追加 PG/鉴权负例。 - 前端：在
web/执行npm test、npm run build；交互变更追加受影响真实浏览器测试。 - 产品 Agent/工作流：真实产品 PI Agent Runner；nightly 入口 仅覆盖 U8 与 FullNoneMixedChain 基线，按范围追加精确测试及 UI 验收。模型按目标环境已批准配置核验，不固定跨环境模型，不自行切换配置。
状态与文档权威
- 任务与合入状态：Gitea Issue / PR（单一来源）。
- CURRENT / FEATURE-MATRIX：只读历史快照（2026-09-29 起不再要求会话同步）。
- 发布门禁：gap-matrix，以有日期、提交和制品身份的证据作判断。
- 问题与修复：问题台账；开发注意事项：经验库。
- 问题与方案：audit、remediation。
凭证与推送
推送模型（2026-09-29 起）：dev/test/main 受 Gitea 保护——用户白名单身份可直推；编码 Agent 以 agent-bot 身份推送功能分支并建 PR，不直推主干。凭证查找 ${HOME}/.secrets/gitea（weichen）与 ${HOME}/.secrets/agent-bot（agent-bot），所需字段为 ACCESS_TOKEN。不向用户索要值，不把凭证写入仓库/git config；缺失只记录路径与缺字段。git-push-dev.sh 仅适用于用户白名单直推场景。
Herdr 工程协作
仅在明确使用 Herdr 编排/启动/派发时读 角色、审批与备援 SSOT；使用 启动脚本 / 派发脚本。此时按 v1.2 资源预算与角色路由执行；普通 Codex/Claude/Cursor 会话不套用该分工。context_pi 是协作终端的 PI CLI，不能替代产品 PI Agent Runner 验收。实际客户端/模型/在线状态记录在本次运行证据中。