メニュー
言語固有の実装スキルが適用できない、または言語をまたぐ既存コードベースの機能追加、修正、リファクタリングで守る共通原則と進め方を定義する。仕様や公開契約を壊さず、既存構造、命名、責務境界に合わせて小さく安全な差分を作るときに使う。Go 実装では code-go など該当する言語別スキルを併用し、レビューのみは code-review を優先する。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/version-1/agents-docs --skill code-generalコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Git リポジトリで新しい作業を始める前に、最新のデフォルトブランチへ追従し、タスク内容に合う作業ブランチを作成して、不要なローカルブランチ整理を非同期に依頼するときに使う。ユーザーが「ブランチ切って」「作業を始める準備して」「新しいタスク用ブランチを作って」「最新 main から始めたい」などを依頼した場合はこの skill を使い、ブランチ名を報告してからタスク詳細の入力を待つ。
Issue Finder agent がコードベースを変更せず、指定された finder 分野の課題を根拠付きで調査し、優先順位付けした Markdown を指定ディレクトリへ出力するときの共通手順、安全制約、品質基準、出力 contract を定義する。
コード、設定、依存関係、権限境界にある悪用可能な脆弱性を安全に調査し、コードを変更せず課題レポートへ整理するため issue-finder agent に委譲するときに使う。一般的なコードレビュー、侵入や攻撃の実行、脆弱性修正には使わない。
| name | code-general |
| description | 言語固有の実装スキルが適用できない、または言語をまたぐ既存コードベースの機能追加、修正、リファクタリングで守る共通原則と進め方を定義する。仕様や公開契約を壊さず、既存構造、命名、責務境界に合わせて小さく安全な差分を作るときに使う。Go 実装では code-go など該当する言語別スキルを併用し、レビューのみは code-review を優先する。 |
言語やフレームワークに依存しない実装作業の共通原則を、小さく、安全で、意図が明確な差分に落とし込む。 動くだけでなく、既存コードベースの読まれ方、直され方、テストされ方に自然に馴染ませる。
言語固有の判断が必要な場合は、このスキルだけで判断せず、該当する言語別スキルを併用する。
Go 実装では code-go を併用する。TypeScript、React、Ruby、CSS などでも対応する言語別スキルがある場合はそれを優先して参照する。
判断に迷ったら、原則として次の順で優先する。
最小変更が責務混在やテスト不能な構造を固定化する場合だけ、変更範囲を説明できる小さな構造改善を含める。 大きな設計変更が必要な場合は、実装に入る前に方針を分けて整理する。
コードを書く前に、最低限次を確認する。
code-go を使う。code-ts を使う。code-react を使い、TypeScript の型設計も必要な場合は code-ts も併用する。code-ruby を使う。code-css を使う。不明点は既存実装、既存テスト、既存命名から先に確認する。 それでも決まらない場合は、仮定を明示して最小の判断にとどめる。
関数名、メソッド名、クラス名、型名、変数名、ファイル名などの命名判断で迷う場合は、code-naming を併用する。
特に次の場合は code-naming の基準を参照する。
最終報告は次を簡潔に含める。