SuperAPI AI 工具集

using-rubypowers

编程与开发

查看项目

更新于 11-02 01:33

技能介绍

用途

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 前端交互实现、调试与计划管理等工作,也适用于需要跨会话保存进度或沉淀解决方案的场景。

限制

  • 技能使用依赖具体平台对技能加载机制的支持;未列出的环境需自行查阅平台文档。
  • 技能内容会演进,应以当前加载版本为准,不应依赖记忆。
  • 用户显式指令始终优先于技能规则。
  • 资料未提供安装命令、收费方式、版本号或平台兼容性细节。