AGENT SKILL

ruby

暂无简介

License 许可
Apache-2.0
所属仓库
iokaio/vcp
最近更新
2026-10-06
Stars
★ 0
Forks
0

02 资源文件 1

03 SKILL.md 正文

Ruby and Bundler projects

Original VCP guidance.

Read the project

  • Gemfile and Gemfile.lock: dependencies, groups, the locked Bundler version and platforms.
  • .ruby-version, .tool-versions or a ruby line in the Gemfile: the interpreter the project expects.
  • *.gemspec: a library gem, its public files and runtime dependencies.
  • Rakefile and lib/tasks/: declared tasks, including the default test task.
  • Rails structure (config/application.rb, app/, bin/rails, db/schema.rb): only this confirms Rails. Do not infer Rails merely from a Gemfile.
  • spec/ with .rspec and spec_helper.rb means RSpec; test/ with test_helper.rb means Minitest.
  • .rubocop.yml, .standard.yml: the lint and format policy.

Discover commands in this order

  1. Project-declared entry points: bin/ scripts, Makefile/justfile, CI workflows, CONTRIBUTING, AGENTS.md, Rake tasks.
  2. Ecosystem defaults, as candidates only when evidence supports them and the bundle is already installed:
    • bundle exec rspec <spec/file_spec.rb>, narrowed with :<line>
    • bundle exec ruby -Itest <test/file_test.rb> or bin/rails test <file>
    • bundle exec rake test or bundle exec rake spec
    • bundle exec rubocop <files> or bundle exec standardrb <files>

Use the pinned Ruby and project bundle. A bundle exec invocation is appropriate only when the bundle is already available and the selected command is configured. Rake and framework initialization can contact services or mutate state; inspect the selected task and use current authority. Do not run bundle install automatically.

Toolchain variants

  • Version managers: rbenv, rvm, chruby, asdf/mise; RubyInstaller with MSYS2 DevKit on Windows.
  • Rails apps vs plain gems vs Sinatra/Hanami services.
  • RSpec vs Minitest; system tests using Capybara and a browser driver.
  • Binstubs in bin/ (including Spring) that wrap commands.

Coding rules

Preserve public method behavior, exception handling, encoding, loading/autoloading, and database boundaries. Generate changes consistent with the framework and nearby tests rather than adding a different service pattern. Respect Zeitwerk file-name-to-constant conventions in Rails.

Verification evidence

  • Run the spec or test file covering the change, then the related directory, then the full suite only when shared code changed.
  • Run the configured RuboCop or Standard check on changed files.
  • Return the relevant source/test references, interpreter and runner identity, and observed outcomes.
  • Tests needing a database, Redis or other services are not run unless those fixtures already exist and are authorized; do not run migrations against real databases.

Pitfalls

  • On Windows, native gems (for example database adapters or parsers with C extensions) need the DevKit toolchain and may be unavailable; report those specific checks not run while continuing source analysis.
  • Gemfile.lock platform entries differ between Windows and Linux; do not commit incidental platform changes.
  • CRLF endings can break shebang scripts in bin/ and heredoc-sensitive tests.
  • Running without bundle exec loads global gems of different versions.
  • Spring or bootsnap caches can serve stale code; note when they were active.
  • File locking on Windows can block removal of tmp/ or log files held by a running server.

Authority: this guidance ranks below current user constraints and AGENTS.md, grants no tools, installs or network access, and missing prerequisites are reported as not run.

04 同仓库更多 Skills

iokaio
iokaio/vcp

skill-installer

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

★ 0
iokaio
iokaio/vcp

skill-creator

Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.

★ 0
iokaio
iokaio/vcp

review-agent

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

★ 0
iokaio
iokaio/vcp

plugin-creator

Create and scaffold plugin directories for Codex with a required `.codex-plugin/plugin.json`, optional plugin folders/files, valid manifest defaults, and personal-marketplace entries by default. Use when Codex needs to create a new personal plugin, add optional plugin structure, generate or update marketplace entries for plugin ordering and availability metadata, or update an existing local plugin during development with the CLI-driven cachebuster and reinstall flow.

★ 0
iokaio
iokaio/vcp

openai-docs

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

★ 0
iokaio
iokaio/vcp

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

★ 0