navi_minco_bit AGENTS.md

AGENTS.md

项目 Agent 行为准则

本文件是本仓库中 AI Agent、Codex、Claude、superpower skill、多 agent 工作流的统一行为规范。
所有代码修改、审计、重构、调参、文档化任务都必须优先阅读并遵守本文件。

本仓库是 RoboMaster 哨兵机器人比赛代码仓库，包含行为树、自主决策、planner、controller、地图、里程计、点云、裁判系统通信、launch、参数文件等模块。仓库中存在已经经过比赛验证的逻辑，任何修改都必须以“保持可复现、最小改动、可审计”为第一原则。

---

0. 最高优先级限制：编译构建限制

禁止在未经用户明确允许的情况下执行任何编译或构建操作，包括但不限于：

• colcon build
• catkin build / catkin_make
• cmake 构建
• make / ninja
• cargo build / cargo check
• npm run build / yarn build
• 任何其他会触发代码编译、链接的命令

在执行任何编译构建命令之前，必须先向用户确认并获得明确许可。

允许在未确认前执行的低风险检查包括：

• grep / rg
• find
• ls
• sed / cat
• python3 静态解析脚本
• XML 语法解析
• YAML 语法解析
• git diff / git status
• 不触发编译、链接、生成代码的静态检查

如果不确定某条命令是否会触发构建，必须先询问用户。

0.1 最高优先级限制：禁止版本控制提交操作

禁止执行任何会改变 Git 历史、Git 索引、远端仓库、分支或标签状态的提交类操作，无论用户是否要求修改代码，均不得由 Agent 主动提交。

禁止命令包括但不限于：

• git add
• git commit
• git commit --amend
• git push
• git tag
• git merge
• git rebase
• git cherry-pick
• git revert
• git reset --hard
• git checkout -- <file> / git restore <file> 等会覆盖工作区修改的命令
• gh pr merge、gh release create 等任何会产生提交、合并、发布或远端变更的命令

允许的只读 Git 检查包括：

• git status
• git diff
• git log
• git show

Agent 只负责修改工作区文件和说明变更，不负责暂存、提交、推送、打标签或合并。
即使任务已经完成，也只能提醒用户自行检查和提交，不能代替用户执行任何提交操作。

0.2 最高优先级限制：禁止 writingplans / 计划说明工具

禁止使用 writingplans、Superpower writing plan、计划说明 skill 或类似工具来生成计划、改造计划、测试计划或阶段说明。

执行方式要求：

1. 用户与 Agent 已经商讨清楚需求和边界后，直接修改代码或文件。
2. 不要在正式修改前额外输出长篇“计划说明”“改造计划说明”“测试计划说明”。
3. 不要新建 writingplans 相关文件。
4. 不要把计划说明作为修改前的阻塞步骤。
5. 必要的任务边界、风险、检查项可以写入最终改造记录或最终回复，但不能调用 writingplans 工作流。
6. 多 Agent 流程只有在用户明确要求时使用，且不得用 writingplans 替代 Explorer / Modifier / Auditor 的实际检查。

允许保留简短的执行摘要和最终检查结果，但不得以 writingplans 形式展开。
核心原则是：商讨完毕后直接按约束修改代码，修改完成后再给出摘要、检查结果和剩余风险。

---

1. 项目背景

本仓库包含但不限于以下模块：

• 行为树与自主决策：bt_manager、行为树 XML、blackboard、裁判系统通信。
• 规划器：MINCO planner、路径搜索、轨迹优化、重规划逻辑。
• 控制器：MPC controller、controller_server、速度输出、参数切换。
• 地图与感知：ROGMap、ProjectionLayer、ESDF、地形投影、动态障碍处理。
• 里程计与点云：Point-LIO / Batch-LIWO、Livox 驱动、完整点云输出、去畸变、odom。
• ROS 2 通信：component container、intra-process、QoS、topic、launch、参数文件。
• 比赛策略：前哨站、冲家、补给、复活、姿态、小陀螺、隧道、台阶、资源兑换。
• 文档与实验材料：论文、申请材料、性能记录、CSV、图片、演讲稿等。