全量项目地图生成
当在 super-agent-v3 中生成、更新或校验 docs/doc/codemap 项目地图、AI index 或能力清单时使用。
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- 全量项目地图生成
- aliases
- [ "@全量项目地图生成", "@codemap" ]
- description
- 当在 super-agent-v3 中生成、更新或校验 docs/doc/codemap 项目地图、AI index 或能力清单时使用。
03 SKILL.md 正文
super-agent-v3 项目地图生成
唯一事实源与产物
- 生成器：
scripts/generate_ai_project_map.mjs。 - 规则输入：
.ai-project-map.overrides.json。 - 生成物：
AI_PROJECT_MAP.md、AI_PROJECT_DRIFT.md、AI_PROJECT_MANIFEST.json和docs/guide/index/*.tsv。
分卷 codemap 由 make codemap-* 管理；能力契约由 make capcontract-* 管理。不得用 make codemap-check 代替项目地图校验。
规则
- 先读 README、codemap README 和生成器中的排除规则，不维护第二份排除清单。
- 修改生成器或 overrides 后运行
make project-map-refresh，不手改生成物。 - 完成前运行
make project-map-check；若同时改分卷 codemap 或能力契约，再追加对应 check。
常见错误
| 错误 | 修正 |
|---|---|
| 生成旧业务子域维度 | 使用当前 cmd/internal/frontend-app 结构 |
| 直接编辑过期生成物 | 修改 owner 后运行 make project-map-refresh |
| 只跑 codemap-check | 项目地图必须运行 make project-map-check |
04 同仓库更多 Skills
mcp-lsp-project-config
配置、安装、检查、修复或迁移项目级 mcp-lsp stdio MCP，覆盖 Codex、Claude Code 和 Google Antigravity，以及 Windows 原生、WSL 原生和 Windows 宿主通过 wsl.exe 桥接 Linux sidecar 的自动选型。用户提到项目 MCP、LSP MCP、.codex/config.toml、.mcp.json、.agents/mcp_config.json、Codex 中 LSP 工具有时直接暴露有时只在延迟工具目录、ALL_TOOLS 过滤为空、工具已显示但调用报 client is closing、EOF、Transport closed，或希望三个客户端共用仓库内 mcp-lsp 时使用。
注释规范
当在 super-agent-v3 中编写或审查 Go 函数级中文注释、React hooks/service/controller 注释，或处理注释守卫失败时使用。
字段守卫
当新增、删除、重命名或跨层传递结构化字段，以及修改 DTO、mapper、schema、API/RPC、事件、配置、store、序列化或前后端契约时自动使用；追踪生产源到全部消费端并建立 fail-fast 字段守卫。
后端
在 super-agent-v3 中编写、审查或重构 Go 后端代码时使用。
前端
当在 super-agent-v3 中开发、审查或修复当前 React/Vite 前端 UI 时使用；前端源码只在 frontend-app。
代码审查维度
当在 super-agent-v3 仓库做代码审查、生产风险审计、裁决子代理发现或编排修复任务时使用。