weichenandCursor
20f52d025b
Rewrite AGENTS.md with taxonomy, worktree, and integration slot rules; add FEATURE-MATRIX-driven CURRENT; tool stubs; session-close checklist. Co-authored-by: Cursor <cursoragent@cursor.com>
4.2 KiB
4.2 KiB
Agent-System 项目地图
1. 产品一句话
面向企业与团队的多用户工作流与对话智能体平台：RAG 知识库、PI Agent 执行、项目治理、阶段门禁、文档审批、任务持久化与 SSE 流式交互。
2. 主要目录
| 路径 | 说明 |
|---|---|
cmd/ |
服务入口 |
internal/ |
Go 业务逻辑（server、coordinator、bizdev、chat、projectinstance 等） |
web/ |
React + Vite 前端 |
deploy/postgres/goose/ |
PostgreSQL 迁移（Goose） |
configs/ |
Agent 与提示词配置 |
templates/ |
工作流文档模板 |
.doc/ |
架构、审计、整改文档 |
.doc/ops/ |
活协作区（CURRENT、任务、checklist、handoff） |
.doc/test-reports/ |
测试/验收报告（归档） |
| `data/dev | test |
scripts/ |
运维与推送脚本 |
3. 技术栈
- 后端：Go HTTP API（~110 路由）
- 前端：React + Vite
- 数据库：PostgreSQL + pgvector（Goose 迁移）
- 智能体：PI Agent Runner（真实 / stub）
- 工作流：main、product_manager、test_manager 三套正式定义
4. Git 三分支与三环境
详见 .cursor/rules/git-workflow-and-environments.mdc。
| 环境 | 分支 | 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 |
红线：知识库共享；对话与业务 DB 严格隔离，禁止跨环境读写。
5. 文档地图（SSOT）
| 用途 | 路径 |
|---|---|
| 文档总地图 | .doc/README.md |
| 协作会话 / 当前焦点 | .doc/ops/CURRENT.md |
| 模块完成度 | .doc/status/FEATURE-MATRIX.md |
| 发布/审计缺口 | .doc/remediation/gap-matrix.md |
| 问题分析 | .doc/audit/INDEX.md |
| 整改方案 | .doc/remediation/INDEX.md |
| 测试报告归档 | .doc/test-reports/ |
| 测试报告规范 | .cursor/rules/test-reports-standard.mdc |
6. 常用命令
# 环境
./scripts/env-service.sh shared start
./scripts/env-service.sh dev start
./scripts/env-service.sh all status
# Go 质量门禁（默认）
go vet ./...
go test -short ./...
# PG 集成（需 TEST_DATABASE_URL）
TEST_DATABASE_URL=postgres://... go test ./internal/server/... -run 'TestE2E_WorkflowGovernance'
# 真实 PI E2E（显式开关）
RUN_PI_E2E=1 RUNNER_AUTH_TOKEN=... go test ./... -run 'PI'
# 前端
cd web && npm test && npm run build
# 数据库迁移
# 见 deploy/postgres/goose/
7. Git 推送（自主，勿索要 token）
- 脚本：
scripts/git-push-dev.sh - 凭证文件：
${HOME}/.secrets/gitea - 字段：
- ACCESS_TOKEN=<token> - URL_PREFIX=<host> - 用法：
./scripts/git-push-dev.sh dev（或 test/main 分支名）
8. 测试与验收铁律
- 开发可用 stub；交付前验收必须真实 PI Agent + MiniMax-M2.7-highspeed 全链路
- 报告必须归档至
.doc/test-reports/，遵循 test-reports-standard - 禁止 stub 输出冒充最终验收数据
9. 当前焦点（动态）
- 发布缺口 SSOT：gap-matrix
- 模块完成度：FEATURE-MATRIX
- 最新测试报告：2026-09-13-codex-audit-p0-remediation-test-report.md
- 剩余 blocker: CI 真实 PI E2E + 前端人工抽检（main 本地冒烟已通过）
10. 语言与提交
- 对用户：简体中文
- 提交：Conventional Commits；在
dev上渐进式分批提交