SuperAPI AI 工具集

aim-common-rules

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:这是 UNNC AIM 团队规范的统一入口,把组织仓库 unnc-aim/.github 中 profile/ 下的书面规则转化为可执行清单和可复制的规则文件(assets/)。书面文档仍是唯一事实来源。

主要能力:覆盖仓库命名(competition / aim- 学年 / 可复用三类)、分支与 Conventional Commits、C++、Python、TypeScript、Go、CMake 及 Markdown/YAML/JSON 文档风格,并提供 .gitattributes、setup.cfg、.clang-format、.clang-tidy、.prettierrc、eslint.config.js、.editorconfig、VS Code 配置等模板。

命名要点:竞赛仓库用 [2位年份][比赛缩写][机器人可选][包名],如 26RC_R2_controller;内部/学年仓库用 aim-[4位年份]-[包名];外部可复用库自由命名。默认分支为 main,竞赛/稳定仓库不得直接推送 main,须走 Pull Request。提交信息遵循 Conventional Commits,type 取 feat、fix、docs 等,subject 不超过 50 字符。

使用方式:用 npx skills add unnc-aim/aim-common-agentic-skills --skill aim-common-rules -g 安装(-g 全局,省略则装入当前项目 .agents/skills/),更新用 npx skills update;也可手动复制整个技能目录到 ~/.claude/skills/ 或仓库 .claude/skills/。不使用 AI 的成员可直接阅读 references/*.md 并复制 assets/。

限制与注意:clang-format 只管排版不管命名;Python 行长为 79,autopep8 不排序导入需配合 isort;standard.cpp.md 示例为 4 空格缩进,但实际 .clang-format 为 2 空格,以 .clang-format 为准;ros2_hik_camera 的 .clang-tidy 变量命名与书面标准冲突,新仓库以书面标准为准。AI 不得在用户未明确要求时执行 git commit/push 或写入型 gh 命令,也不得添加 AI 共同作者尾注。