Skip to content

docs(agents): add agent guidance suite with test consolidation and cleanup - #1392

Merged
xuwei-fit2cloud merged 4 commits into
mainfrom
docs/agent-guidance-suite
Sep 24, 2026
Merged

xuwei-fit2cloud merged 4 commits into
mainfrom
docs/agent-guidance-suite

Conversation

@ulleo

@ulleo ulleo commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

变更内容

Agent 指引文档体系

  • 根 AGENTS.md:仓库结构、xpack 工作流入口、按需文档指针表、全局硬规则(含提交规范:conventional 前缀、不加 AI 署名行)
  • CONTEXT.md:领域词汇表(含 Avoid 反例)
  • docs/agents/:backend / frontend / testing / i18n / security / migrations / packaging / xpack / domain-open-questions 九份按需文档,其中 xpack.md 覆盖主工程对 xpack 的运行时依赖与源码联调前提
  • g2-ssr/AGENTS.md:图表渲染服务的目录级指引

测试归并与清理

  • 根目录 tests/ 全部并入 backend/tests/,统一从 backend/ 运行 uv run pytest -q
  • 删除永久跳过的 test_minimax_integration.py 与引用旧 app/ 布局的 4 个死脚本(lint.sh / test.sh / tests-start.sh / prestart.sh,保留现行有效的 format.sh 与 alembic/)
  • 更新两个过时守卫:README 供应商章节断言(5efc0d85 已移除该章节)、LogWithAi v-else 断言(fcf858cc 的有意变更)

配置修复

  • Ruff target-version py310 → py311(与 requires-python = "==3.11.*" 对齐)
  • .gitignore 补充本机环境与 /logs/ 条目
  • g2-ssr/package.json name:vite-project → sqlbot-g2-ssr

验证

  • cd backend && uv run pytest -q → 216 passed, 0 skipped
  • 迁移测试文件 ruff check / format 通过,文档引用无残留

@xuwei-fit2cloud
xuwei-fit2cloud merged commit 4d5950c into main Sep 24, 2026
3 checks passed
@xuwei-fit2cloud
xuwei-fit2cloud deleted the docs/agent-guidance-suite branch September 24, 2026 06:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants