一套精简的工程技能，适用于 Claude Code、Codex 以及其他能加载 SKILL.md 目录的 agent。

不需要先学工程规范：装上之后，agent 会先问清需求，改完拿证据验证；遇到删库、删文件、改服务器这类操作，会先停下来确认。

亮点

• 团队实战出来的。 我所在公司的研发部门自 2026 年 6 月起有数十人日常使用这套技能，他们用的是加入了具体业务内容的定制版；这里是去掉业务内容的通用版。技能里不含任何公司、产品、主机或部署信息，私有信息放在本地 项目 Profile 里。文档中文优先，另有完整英文版。
• 用评测说话，不靠自述。 在 Claude Code 和 Codex 上评测会不会根据一句普通的话选中技能，在 Claude Code 上还评测选中后做得对不对。增删技能或改了描述，推送前要在真实客户端上跑受影响的选用用例做验收；技能正文的规则好不好用，看实际开发中的反馈。用例都在 evals/。
• 危险操作有刹车。 删库、删文件、改服务器、碰生产环境之前，先只读确认目标和影响范围，备份和回滚准备好、你明确同意后才写。这些是写给 agent 的规则，不是拦截机制；要硬性限制，请用客户端自己的权限设置。
• 小事不折腾。 改一行文案不写计划、不做评审，改完跑最相关的检查就交付。每条技能描述不超过 100 词，由校验器把关，常驻上下文的开销很小。
• 验证一次，以后照着做。 项目验证配方把“怎么启动、点哪里、看到什么算成功”写下来，并实际跑通一次。下一个 agent 不用重新摸索，改完直接照着验证真实功能。
• 跨客户端，能协作。 同一套技能可以装进 Claude Code、Codex 和其他读 SKILL.md 的客户端；还能把任务交给本机的另一个 CLI 或模型去执行，或者请你配置的几个模型同时独立评审同一份改动；agent 自己也评一遍，逐条对照代码核实后合并成一份报告，注明每条问题是哪几个模型提出的。

装上之后有什么不同

一个任务怎么走

以“订单页报 500，修一下”为例：

1. rumo-debug 先复现报错，沿调用链找到原因，并用日志、请求或数据证明原因成立，不靠猜。
2. rumo-test 先写一个能复现这个缺陷的测试，确认它在修复前失败。
3. 修复代码，看着这个测试转绿，再跑周边的测试。
4. 项目有验证配方时，照着它启动应用、打开订单页，确认真实页面恢复正常，并保存证据。
5. rumo-verify 交付前列出实际跑过的命令和结果；没跑的检查直接说明，不说“应该没问题”。
6. 你说提交，rumo-git-commit 才会按仓库约定提交；推送同样要你明确要求。

小改动、新功能、重构、性能问题、原型、暂停等其他任务也各有默认路线，由 rumo-coding-guidelines 选择，完整列表见 task-flows.md。

想指定技能时可以点名调用（用插件安装时，Claude Code 的技能名要带前缀，例如 /rumo-engineering-skills:rumo-clarify）：

标注“仅手动调用”的技能不会被自动选用，使用时必须点名。完整案例展示了三个请求从提出到交付的全过程。

快速开始

Claude Code 插件

只用 Claude Code 时推荐这种方式，不需要 clone。在会话里执行，然后开一个新会话（需要 Claude Code 2.1.275 或更高版本）：

/plugin install rumo-engineering-skills --marketplace rumoii/rumo-engineering-skills

在终端里用 claude plugin install rumo-engineering-skills --marketplace rumoii/rumo-engineering-skills（需要 2.1.292 或更高版本）。更早的版本先添加插件市场再安装：

claude plugin marketplace add rumoii/rumo-engineering-skills
claude plugin install rumo-engineering-skills@rumo-engineering-skills

插件里的技能名带前缀，例如 /rumo-engineering-skills:rumo-clarify。插件只对 Claude Code 生效，不含扩展；其他客户端用安装器。同一台机器只选一种方式：安装器已经把技能链接进 ~/.claude/skills 时再装插件，每个技能都会出现两次。

让 AI 帮你安装

用 Codex 或其他客户端时，把下面这段提示词发给你的 agent，它会先预演、再安装，并告诉你改了什么：

按 https://github.com/rumoii/rumo-engineering-skills 的 README 安装这套技能。
1. 本地没有就先 clone，然后用 --dry-run(Windows 用 -DryRun)运行安装器，把它会改动的内容告诉我。
2. 不带 --baseline 正式运行安装器，告诉我链接了哪些客户端。
3. 写入我的用户级 CLAUDE.md 或 AGENTS.md 之前先问我；我同意了，才带 --baseline(-Baseline)重跑，并把加进去的内容给我看。
4. 列出改动过的文件，并提醒我开新会话。
5. 提醒我在新会话里运行 rumo-setup，选择多模型评审和委派用的 agent、模型和思考强度。

AI 没收到这段提示词、只按 README 安装时，也遵守同一条规则：没有用户明确同意，绝不加 --baseline 或 -Baseline，因为它会改用户自己的说明文件。

用安装器安装

需要 Git 和 Python 3，不需要管理员权限。-ExecutionPolicy Bypass 只对这一次运行生效，不改系统设置。后文的 Windows 命令简写成 .\install.ps1 ...；系统禁止运行脚本时，照这里写成 powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 ...。

git clone https://github.com/rumoii/rumo-engineering-skills.git
cd rumo-engineering-skills
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -NoPull

git clone https://github.com/rumoii/rumo-engineering-skills.git
cd rumo-engineering-skills
./install.sh --no-pull

安装器先校验仓库，再把默认技能链接到检测到的每个客户端（Codex、Claude Code 和共享的 ~/.agents 目录）。它只管理 rumo-* 链接，不动其他技能。成功时每个客户端会输出一行 <数量> skills linked in <目录>，最后一行以 Next: 开头。装完开一个新会话，让客户端重新加载技能列表。

第一次配置 agent（可选）

agent 可以调用你本机装的其他 AI 编程工具，请它们独立复查改动，或者把活交给它们做。不配也完全能用；本机只有当前这一个 AI 工具时不用配。想用时，装好后开新会话运行 /rumo-setup（插件里是 /rumo-engineering-skills:rumo-setup，Codex 里是 $rumo-setup）：它会逐项解释每个配置、给出带理由的推荐，探测通过后才写入 ~/.rumo-engineering-skills/agents.json。别的工具只在被调用时才花额度；你没点名时，agent 默认先问你再请它们。以后重跑它，或直接说“把评审换成 grok，思考强度 high”即可修改。

实际跑通过的 CLI 是 codex、claude、grok、pi、qwen；aider、cline、copilot、cursor、goose 是实验性的，gemini、opencode 已停用，原因和升级为支持的方法见 adapters.md。

遇到问题

• 装不上、装完看不到技能、技能出现两次：先看新手指南的遇到问题，按看到的现象找对应小节。
• 安装器报错时，加 -DryRun（--dry-run）重跑，保存完整输出。
• 仍未解决：提交问题，附上 -DryRun 输出、git rev-parse HEAD 和客户端版本。issue 是公开的，贴出前删掉用户名、公司路径和代码。

支持范围

点名调用成功只说明客户端加载了技能，不说明它会根据自然语言自动选中技能。其他客户端的接入方式见新手指南。外部 agent 的 start / resume 目前只支持 Windows 和 Linux/WSL；其他平台（包括 macOS）只能查看已有运行记录，安装技能不代表可以使用这些外部运行功能。

默认技能

默认安装。

可选扩展

默认不安装，只能通过安装器添加，插件不含扩展。

.\install.ps1 -NoPull -ListExtras
.\install.ps1 -NoPull -Extras rumo-diagram,rumo-document-writing
.\install.ps1 -NoPull -RemoveExtras rumo-document-writing

./install.sh --no-pull --list-extras
./install.sh --no-pull --extras rumo-diagram,rumo-document-writing
./install.sh --no-pull --remove-extras rumo-document-writing

装过的扩展在不带参数重跑安装器时会保留。

常驻基线

客户端只在 description 与请求匹配时才加载技能，小改动可能跳过 rumo-coding-guidelines 的基线规则，技能之间也可能接不上。安装器可以把核心规则、风险关卡和一张“什么情况用哪个技能”的路由表写进检测到的客户端的用户级说明文件：Claude Code 目录下的 CLAUDE.md，以及 Codex 目录下的 AGENTS.md。写入的内容位于 rumo-engineering-skills:baseline 标记之间，标记之外的内容不会改动。

.\install.ps1 -NoPull -Baseline
.\install.ps1 -NoPull -RemoveBaseline

./install.sh --no-pull --baseline
./install.sh --no-pull --remove-baseline

之后不带参数重跑安装器时会自动更新这段内容；没写入过的，安装结束时会提示一行。插件用户和其他客户端第一次运行 rumo-setup 时，它会问要不要写入当前客户端的用户级说明文件，不需要 clone 仓库；用的不是 Claude Code 或 Codex 时，它会先问你那个文件的路径。也可以在 clone 下来的仓库目录里直接运行辅助脚本，例如 python3 skills/rumo-coding-guidelines/scripts/baseline_block.py --target ~/.claude/CLAUDE.md --install，也可以手动把 agents-snippet.md 里的代码块贴进去。

更新与卸载

安装器只会写这几处：客户端技能目录里的 rumo-* 链接；你同意后写入 CLAUDE.md、AGENTS.md 的基线标记块；以及用 -ProfilesRepo 时保存的 ~/.rumo-engineering-skills/config.json。

更新。 安装器：去掉 -NoPull（--no-pull）重跑 .\install.ps1 或 ./install.sh，它会先 git pull --ff-only 拉取最新版本，再重新链接，已装的扩展和基线会保留，然后开新会话。如果 pull 成功而后续校验或安装失败，安装器会额外警告现有链接可能已经提供新内容；这不表示仓库已回滚。插件：先执行 claude plugin marketplace update rumo-engineering-skills，再执行 claude plugin update rumo-engineering-skills@rumo-engineering-skills，然后开新会话。已装的插件只在发版提升 version 后才会更新；每版改了什么见 CHANGELOG.md。安装器装的是指向本仓库的链接，想固定在某个版本时，在仓库目录执行 git checkout v0.9.0 这类发版标签，再加 -NoPull（--no-pull）重跑安装器；回到最新版本时先 git checkout main，再不带 -NoPull 重跑。

卸载。 安装器：可以先加 -DryRun（--dry-run）看会删什么，再运行 .\install.ps1 -Uninstall 或 ./install.sh --uninstall。卸载只删除指向本仓库的 rumo-* 链接和常驻基线，不碰其他来源的技能；clone 下来的仓库、~/.rumo-engineering-skills/config.json 和项目 Profile 都会保留，不再需要时手动删除。插件：执行 claude plugin uninstall rumo-engineering-skills@rumo-engineering-skills，然后开新会话。

不要在资源管理器里删除 rumo-* 链接，也不要用 Remove-Item -Recurse 删除：这些操作可能顺着链接删掉仓库里的技能文件。

进阶

Profile 是可选的，不是使用技能的前提。仓库名称、组件清单、主机、服务名、安装目录和凭据应放在本地 Profile 或私有 Profile 仓库中，绝不放进本仓库。创建、填写和检查方法见新手指南。

环境变量：

• RUMO_SKILLS_REPO：固定的本地仓库
• RUMO_SKILLS_REMOTE：克隆地址
• RUMO_SKILL_PROFILES_REPO：私有 Profile 仓库
• RUMO_PROJECT_PROFILE：显式指定 Profile
• RUMO_AGENTS_CONFIG：另一份 agent 配置，例如某个仓库长期用另一套线路时
• CODEX_HOME、CLAUDE_HOME、AGENTS_HOME：自定义客户端目录

安装时加 -ProfilesRepo <path> 或 --profiles-repo <path> 可把 Profile 仓库路径保存到 ~/.rumo-engineering-skills/config.json。

改技能或脚本前先读贡献指南。

py -3 scripts\verify_skills.py
py -3 -m unittest discover -s scripts\tests -p "test_*.py"
py -3 scripts\run_auxiliary_tests.py

python3 scripts/verify_skills.py
python3 -m unittest discover -s scripts/tests -p 'test_*.py'
python3 scripts/run_auxiliary_tests.py

Windows 没有 py 启动器时改用 python。install.sh 的测试只在 Linux、macOS 或 WSL 中运行，在 Windows 上会被跳过。校验器检查命名、frontmatter、界面元数据、相对链接、按默认与扩展分组的目录清单、默认技能篇幅、description 长度、技能内脚本路径、触发用例覆盖、多余的许可文件、JSON 语法、疑似密钥和被跟踪的凭据文件。如需拦截私有词汇，把词条写入 ~/.rumo-engineering-skills/forbidden-terms.txt（或 RUMO_FORBIDDEN_TERMS_FILE 指定的文件），每行一个，正则以 re: 开头；该文件不要放进仓库。

这些命令检查的是仓库，不是安装结果。安装结果的检查方法见新手指南。

自动选用由调用模型的评测覆盖，客户端为 Claude Code 和 Codex CLI。行为评测在 Claude Code 上运行，覆盖单技能用例和跨技能的 chain-* 用例。其他客户端只验证过安装和加载。各项评测能证明什么，见 CONTRIBUTING.md。

文档

• 新手指南
• 技能目录
• 贡献指南
• 安全策略
• 更新记录 · 版本说明

安全

• 不要提交密码、凭据文件、Token、私钥或含私有材料的证书。
• 安装器、Profile 解析、脚本、测试和报告都不得打印密钥值。
• 默认只访问 localhost 或明确标识为开发、测试的环境。生产环境需要精确授权，并且除非另行批准变更，一律只读。

漏洞请按 SECURITY.md 私下报告，不要开公开 issue。

Star 趋势

许可

MIT，见 LICENSE。