convez.ai
Skill
hideki1219

claude-code-skillset

hideki1219/claude-code-skillset

Ver no GitHub
InicialPluginScore · de 0 a 100

Instalação

$npx convez-ai hideki1219/claude-code-skillset

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Claude Code 武器庫 — Next.js Web アプリ開発用スターターキット

Claude Code の能力を最大限引き出すための拡張一式。リポジトリ直下にそのまま配置して使う。 各ファイルは自己完結で書かれているため、低レベルのモデルに「この形式で◯◯のスキルを作って」と渡せばそのまま量産できる。

設計思想 — 5つの拡張ポイントの使い分け

拡張ポイント役割一言でいうと読み込まれるタイミング
CLAUDE.md憲法常に守る短い絶対ルール毎セッション常時
skills/知識工程ごとの手順書・規約関連タスクの時だけ
hooks/強制AIの善意に頼らない機械的ガードツール実行の前後に自動
commands/定型作業よくやる作業のワンコマンド化/コマンド名 で明示的に
agents/分業別人格・別コンテキストでの専門作業必要時に自動 or 指名

判断基準:

  • 絶対に毎回守らせたい短いルール → CLAUDE.md(長くしない。長い知識はスキルへ)
  • 特定の工程でだけ必要な長い知識 → スキル(コンテキストを汚さない)
  • 「守ってほしい」では足りない、確実に止めたい操作 → hooks(LLMは確率的、hooksは決定的)
  • 毎回同じ指示を打っている作業 → コマンド
  • 「書いた本人と別の目」が欲しい作業(レビュー・監査) → サブエージェント

ファイル構成

CLAUDE.md                      # プロジェクト規約(憲法)
.claude/
├── settings.json              # hooks 設定 + 許可/拒否パーミッション
├── hooks/                     # Node.js 製(クロスプラットフォーム)
│   ├── block-dangerous.mjs    # [実行前] rm -rf / force push / DROP 等をブロック
│   ├── protect-files.mjs      # [編集前] .env / 既存マイグレーション等の編集をブロック
│   ├── format-on-edit.mjs     # [編集後] Prettier 自動整形
│   └── stop-typecheck.mjs     # [完了時] 型エラーが残っていたら差し戻す品質ゲート
├── commands/
│   ├── plan.md                # /plan   実装計画のみ(コード変更禁止)
│   ├── tdd.md                 # /tdd    テスト先行で実装
│   ├── review.md              # /review 差分レビュー
│   ├── commit.md              # /commit Conventional Commits でコミット
│   └── pr.md                  # /pr     品質チェック後に PR 作成
├── agents/
│   ├── code-reviewer.md       # レビュー専門(修正権限なし)
│   ├── test-writer.md         # テスト専門(実装コード変更禁止)
│   └── security-auditor.md    # セキュリティ監査(読み取り専用)
└── skills/
    ├── requirements/          # 【要件定義】曖昧な要望→検証可能な要件
    ├── design-doc/            # 【設計】設計書 + ADR
    ├── nextjs-conventions/    # 【実装】App Router 規約
    ├── db-schema/             # 【実装】Prisma スキーマ/マイグレーション規約
    ├── testing/               # 【テスト】Vitest + Playwright 規約
    ├── debugging/             # 【保守】障害調査の手順
    └── release-notes/         # 【リリース】CHANGELOG / PR説明文

工程カバレッジ

要件定義 ──► 設計 ──────► 実装 ─────────► テスト ──► レビュー ──► リリース ──► 運用保守
requirements design-doc   nextjs-conventions testing   code-reviewer release-notes debugging
(/plan)      (ADR)        db-schema          (/tdd)    (/review)     (/commit /pr) 
                          + hooks が全工程を常時ガード + stop-typecheck が完了品質を担保

導入手順

  1. このフォルダの中身をプロジェクトルートにコピーする(.claude/ と CLAUDE.md)
  2. CLAUDE.md の技術スタック・コマンドを実プロジェクトに合わせて書き換える (pnpm → npm、Prisma → Drizzle 等。スキル内のコマンド名も同様に)
  3. package.json に typecheck: "tsc --noEmit" 等のスクリプトがあることを確認する
  4. Claude Code を起動し、/hooks で hooks が認識されているか確認する
  5. 動作確認: 「.env を読んで」と頼んでブロックされれば成功

注意:

  • hooks は Node.js で書いてあるため、Next.js プロジェクトなら追加依存ゼロで動く
  • settings.json はチーム共有用。個人設定は settings.local.json に分離する
  • 仕様の確認は公式リファレンス: https://code.claude.com/docs/en/hooks

低レベルモデルでも量産できる「言語化」原則

新しいスキル・コマンド・エージェントを(人間でも弱いモデルでも)作る時は、この5原則を守る。 この原則自体をプロンプトに貼り付ければ、量産を指示できる。

  1. 1ファイル1責務。 「テストとデバッグのスキル」のように混ぜない。迷ったら分割する。
  2. description にトリガー条件を全部書く。 スキルが使われるかは description だけで決まる。 「何をするか」+「ユーザーがどんな言葉を使った時に発動するか」を具体的な語彙で列挙し、 少し押し付けがましいくらいに「必ず使う」と書く(スキルは発動しそびれる方向に偏るため)。
  3. 本文は命令形+具体例。 「〜が望ましい」ではなく「〜する」「〜禁止」。 抽象的な規約には必ず短いコード例かテンプレートを1つ添える。
  4. 理由を1行添える。 「禁止(履歴が壊れるため)」のように書くと、モデルが応用判断できる。
  5. 短く保つ。 スキル本文は100行以内を目安、最大でも500行。 超えたら references/ サブファイルに分離し、SKILL.md から「いつ読むか」を指示する。

加えて、種類ごとの型:

  • スキル = skills/<名前>/SKILL.md。frontmatter に name と description(原則2が最重要)
  • コマンド = commands/<名前>.md。本文がそのままプロンプトになる。$ARGUMENTS で引数を受ける
  • エージェント = agents/<名前>.md。frontmatter の tools で権限を絞るのが本質 (レビュアーに Write を与えない=「口だけ出す」を構造で保証する)
  • hook = 「LLM に守らせる」のではなく「機械的に不可能にする」もの。 exit 0 = 許可、exit 2 + stderr = ブロック(stderr の文章が Claude への指導になる)

運用のコツ

  • 同じ指摘を2回したら、それは CLAUDE.md かスキルに追記するサイン
  • 同じ事故が2回起きたら、それは hooks に追加するサイン(ルールではなくガードにする)
  • スキルが発動しない時は description を疑う(本文ではなく)
  • 定期的に CLAUDE.md を見直し、守られていないルールは「短くする・具体化する・hooks 化する」のどれかで対処する
Ver o original no GitHub

Bom para

Relacionados