riot-org/riot

riot-org/riot · .riot/skills/add-command/SKILL.md · 给前端加一个 Tauri 命令时用。要改五处，漏了其中三处只表现为运行时「command not found」；权限文件还有个先后顺序的坑会让 build.rs 直接 panic。

riot-org/riot · .riot/skills/add-tool/SKILL.md · 给 Riot 加一个模型能调的工具时用。Tool trait 的必答项、fail-closed 默认值的判据、注册位置、以及几条写错了不报错只是行为悄悄降级的规则。

riot-org/riot · .riot/skills/commit-batch/SKILL.md · 工作区堆了多个不相关主题的改动、要整理成提交时用。按主题切分而不是拆成一堆小提交，并照这个仓库的消息风格写。

riot-org/riot · .riot/skills/mutate/SKILL.md · 动过权限决策链、Bash 分析、路径围栏、安全检查、文件工具或进程执行器之后用。跑变异测试，并正确解读存活的变异。

riot-org/riot · .riot/skills/protocol-change/SKILL.md · 改了 crates/riot-protocol 里的类型之后用。重新生成绑定，并检查 serde tag 撞名这类 Rust 类型层面看不出来的问题。

riot-org/riot · .riot/skills/review/SKILL.md · 审查一批改动时用。缺陷优先，并按这个仓库特有的失效方式去找问题——那些编译通过、类型正确、看起来合理的写法。

riot-org/riot · .riot/skills/verify/SKILL.md · 改完代码要验证时用。按这个仓库的分层防线依次跑，并说明每一层拦的是什么。别只跑 cargo build 就当验证过了。

riot-org/riot · crates/riot-kernel/builtin/skills/add-mcp/SKILL.md · 用户想加、改、排查 MCP 服务器，或从 Cursor / Claude Desktop / VS Code 搬 MCP 配置过来时用。用户级只认 stdio（远程走 mcp-remote 桥）、config.json…

riot-org/riot · crates/riot-kernel/builtin/skills/commit/SKILL.md · 要把改动提交成 git commit 时用。先看清工作区里有几件事、按主题分组、只暂存这一组，以及消息里该写什么不该写什么。

riot-org/riot · crates/riot-kernel/builtin/skills/create-plugin/SKILL.md · 用户想写一个 Riot 插件、把已有的技能/命令/hooks/MCP 打包分发、或把 Claude Code / Cursor 插件搬到 Riot 时用。目录布局、三种清单格式、dev.riot 扩展字段、本地链接调试流程和市场发布。

riot-org/riot · crates/riot-kernel/builtin/skills/debug/SKILL.md · 排查 bug 时用。顺序是硬的：先复现、再让证据淘汰假设、修根因、用原始复现路径验证。不要看到第一个可疑点就动手改。

riot-org/riot · crates/riot-kernel/builtin/skills/extend-riot/SKILL.md · 用户想加技能、斜杠命令、hook、项目约定（AGENTS.md），或要给命令配 API key、密码这类机密时用。各扩展点的目录、格式限制和优先级规则。MCP 服务器转 add-mcp，打成可分发的插件转 create-plugin。

riot-org/riot · crates/riot-kernel/builtin/skills/retro/SKILL.md · 任务磕磕碰碰才做成、被纠正了好几次之后用；用户说「复盘」「总结经验」「记下来」时也用。回顾这次会话的纠错轨迹，筛出下次还会犯的错，沉淀进 AGENTS.md 或技能，同类任务下次不用再教一遍。

riot-org/riot · crates/riot-kernel/builtin/skills/review/SKILL.md · 审查一批改动时用。缺陷优先：找静默的错答案、反了的失败方向、没测试守着的关键分支，按严重程度报告并说清审了多大范围。风格问题交给 lint，不在这里人肉报。

riot-org/riot · crates/riot-kernel/builtin/skills/simplify/SKILL.md · 功能跑通之后、交付之前的收尾清理。按复用、质量、效率三张清单过一遍刚改的代码并修掉发现的问题。只碰这次改动的范围，不搞漫游式重构。

riot-org/riot · crates/riot-kernel/builtin/skills/skillify/SKILL.md · 用户说「做成技能」「以后都这么做」，或一套流程试错多次才跑通、下次还会用时。把步骤、完成判据和用户纠正过的点提炼成 SKILL.md，和用户确认后再写。

riot-org/riot · crates/riot-kernel/builtin/skills/split-to-prs/SKILL.md · 把一堆改动拆成几个各自能审的小 PR 时用。先提拆分方案、经用户确认才动 git；动手前先做不碰工作区的可恢复快照，只暂存计划内的文件。

riot-org/riot · crates/riot-kernel/builtin/skills/verify/SKILL.md · 改完代码要验证时用。先从 CI 配置和构建脚本摸清这个项目把什么当作「过了」，再按静态检查、测试、真跑一遍的顺序执行。别把「编译过了」当成「验证过了」。