ruby
暂无简介
- License 许可
- Apache-2.0
- 所属仓库
- iokaio/vcp
- 最近更新
- 2026-10-06
- Stars
- ★ 0
- Forks
- 0
02 资源文件 1
- 参考文档skill.json574 B
03 SKILL.md 正文
Ruby and Bundler projects
Original VCP guidance.
Read the project
GemfileandGemfile.lock: dependencies, groups, the locked Bundler version and platforms..ruby-version,.tool-versionsor arubyline in the Gemfile: the interpreter the project expects.*.gemspec: a library gem, its public files and runtime dependencies.Rakefileandlib/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.rspecandspec_helper.rbmeans RSpec;test/withtest_helper.rbmeans Minitest..rubocop.yml,.standard.yml: the lint and format policy.
Discover commands in this order
- Project-declared entry points:
bin/scripts, Makefile/justfile, CI workflows, CONTRIBUTING, AGENTS.md, Rake tasks. - 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>orbin/rails test <file>bundle exec rake testorbundle exec rake specbundle exec rubocop <files>orbundle 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.lockplatform 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 execloads 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
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).
skill-creator
Create or update a Codex skill with appropriately scoped instructions and any needed supporting resources.
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.
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.
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.
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.