用途
RubyPowers 是一套面向 AI 编程助手的技能体系,本页(using-rubypowers)是该体系的总入口与使用规则说明。其核心作用是在会话开始时建立“如何查找并使用技能”的机制,确保 AI 在给出任何回应(包括提出澄清问题)之前先调用相应技能。
主要能力
调用规则与优先级
- 规定必须在任何回应或动作之前调用相关或用户请求的技能;即使只有 1% 的可能性适用,也应先调用技能检查。
- 明确指令优先级:用户显式指令(CLAUDE.md、GEMINI.md、AGENTS.md、直接请求)最高;RubyPowers 技能在冲突处覆盖默认系统提示词;默认系统提示词优先级最低。
- 强调用户掌控权:若用户文档说“不要用 TDD”而技能说“总是用 TDD”,应遵从用户指令。
各环境中的访问方式
- Claude Code:使用 Skill 工具,调用后内容被加载并直接遵循,不应使用 Read 工具读取技能文件。
- Copilot CLI:使用 skill 工具,技能从已安装插件自动发现,行为与 Claude Code 的 Skill 工具相同。
- Gemini CLI:通过 activate_skill 工具激活,Gemini 在会话开始时加载技能元数据,按需激活完整内容;工具映射通过 GEMINI.md 自动加载。
- 其他环境:需查阅对应平台文档了解技能加载方式。
流程与技能优先级
页面以流程图描述会话处理流程:收到用户消息后判断是否即将进入计划模式,若尚未头脑风暴则调用 brainstorming 技能;随后判断是否可能有技能适用,有则调用 Skill 工具并宣告“Using [skill] to [purpose]”;若技能含检查清单,则按条目创建 TodoWrite 待办并严格遵循。
多技能适用时优先级为:先流程类技能(头脑风暴、调试),再实现类技能(前端设计、MCP 构建)。例如“构建 X”先头脑风暴再实现技能,“修复 bug”先调试再领域技能。
红标判断
页面列出若干“合理化”想法并逐一反驳,例如“这只是简单问题”(问题也是任务,应检查技能)、“我需要先了解上下文”(技能检查在澄清问题之前)、“先探索代码库”(技能会告诉你如何探索)、“我记得这个技能”(技能会演进,应读当前版本)等,提示这些想法应触发停止并先检查技能。
技能类型
- 刚性技能(TDD、调试):严格遵循,不应绕开纪律。
- 柔性技能(模式类):根据上下文适配原则。
- 技能自身会说明属于哪一类。
技能目录概览
- 流程与工作流:brainstorming(任何创造性工作开始前,必需)、test-driven-development(实现功能或修复缺陷前,必需)、systematic-debugging、writing-plans、executing-plans、dispatching-parallel-agents、subagent-driven-development、verification-before-completion、finishing-a-development-branch、using-git-worktrees、compound。
- 会话连续性:handoff、handoff-resume、handoff-list。
- Ruby 与 Rails:ruby(纯 Ruby 惯用模式、Ruby 3.x+ 特性、记忆化、结果对象)、rails-guides(ActiveRecord、路由、控制器、视图、邮件、任务、Action Cable、Action Text、Active Storage、迁移、校验、关联、缓存、安全)、37signals-style、ruby-commit-message(Conventional Commits 格式)、sandi-metz-rules(类 <100 行、方法 <5 行、参数 ≤4、每个控制器动作一个对象)。
- Hotwire 与 Stimulus:hwc-stimulus-fundamentals、hwc-navigation-content、hwc-forms-validation、hwc-ux-feedback、hwc-realtime-streaming、hwc-media-content。
- 安全:brakeman(Rails 安全审计、SQL 注入/XSS/命令注入分析、CI/CD 安全扫描)。
- 代码评审与质量:requesting-code-review、receiving-code-review。
- 元技能:writing-skills、compound、compound-refresh。
使用方式
在支持的 AI 编程环境中安装或启用 RubyPowers 技能集后,按提示调用 Skill 工具(或对应平台的技能激活工具)加载具体技能;调用时先宣告所用技能及目的,再严格按技能内容执行。不同平台的具体安装命令与配置细节,资料暂未提供。
适用场景
适用于使用 AI 编程助手进行 Ruby/Rails 项目开发、代码评审、安全审计、Hotwire 前端交互实现、调试与计划管理等工作,也适用于需要跨会话保存进度或沉淀解决方案的场景。
限制
- 技能使用依赖具体平台对技能加载机制的支持;未列出的环境需自行查阅平台文档。
- 技能内容会演进,应以当前加载版本为准,不应依赖记忆。
- 用户显式指令始终优先于技能规则。
- 资料未提供安装命令、收费方式、版本号或平台兼容性细节。