skanehira

creating-rules

@skanehira/creating-rules
skanehira
80
4 forks
Updated 1/6/2026
View on GitHub

.claude/rules/ディレクトリにベストプラクティスに沿ったルールファイル(.md)を作成します。コーディングルール、テスト規約、セキュリティ要件などのプロジェクト固有の指示を作成する場合に使用します。paths frontmatterによる条件付きルール、適切なファイル名、サブディレクトリ構造をサポートします。

Installation

$skills install @skanehira/creating-rules
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathclaude/skills/creating-rules/SKILL.md
Branchmain
Scoped Name@skanehira/creating-rules

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: creating-rules description: .claude/rules/ディレクトリにベストプラクティスに沿ったルールファイル(.md)を作成します。コーディングルール、テスト規約、セキュリティ要件などのプロジェクト固有の指示を作成する場合に使用します。paths frontmatterによる条件付きルール、適切なファイル名、サブディレクトリ構造をサポートします。

Creating Rules

.claude/rules/ディレクトリにベストプラクティスに沿ったルールファイルを作成する。

ワークフロー

1. 要件の確認

ユーザーに以下を確認:

  • ルールのトピック(例:コードスタイル、テスト、セキュリティ)
  • 対象ファイル(特定のパスに限定するか)
  • サブディレクトリに配置するか

2. ルールファイルの作成

ディレクトリ構造

.claude/rules/
├── code-style.md      # 全体に適用
├── testing.md         # 全体に適用
├── frontend/          # サブディレクトリで整理
│   ├── react.md
│   └── styles.md
└── backend/
    ├── api.md
    └── database.md

ファイル形式

条件なしルール(全ファイルに適用):

# [トピック名]

- ルール1
- ルール2

条件付きルール(特定ファイルのみ適用):

---
paths: src/**/*.ts
---

# [トピック名]

- ルール1
- ルール2

paths globパターン

パターンマッチ対象
**/*.ts全ディレクトリのTypeScriptファイル
src/**/*src/以下の全ファイル
*.mdルートのMarkdownファイル
src/**/*.{ts,tsx}src/以下のTS/TSXファイル
{src,lib}/**/*.ts, tests/**/*.test.ts複数パターンの組み合わせ

3. ベストプラクティス

詳細は references/best-practices.md を参照。

要点:

  • 焦点を絞る: 1ファイル1トピック
  • 説明的なファイル名: 内容が分かる名前
  • 条件付きルールは控えめに: 本当に必要な場合のみpathsを使用
  • サブディレクトリで整理: 関連ルールをグループ化
  • 具体的に記述: 「コードを適切にフォーマット」より「2スペースインデントを使用」

4. 作成後の検証

作成したルールファイルを検証:

  1. 配置確認: .claude/rules/に正しく配置されているか
  2. 構文確認: frontmatterのYAML構文が正しいか
  3. パターン確認: pathsのglobパターンが意図通りか
  4. 内容確認: ルールが具体的で実行可能か

検証コマンド例:

# ファイル一覧を確認
ls -la .claude/rules/

# frontmatterの構文確認(pathsが正しいか)
head -10 .claude/rules/[ファイル名].md

問題があれば修正し、再度検証する。

5. 完了確認

  • ルールが正しく読み込まれることを確認
  • /memoryコマンドで読み込み状況を確認可能

More by skanehira

View all
analyzing-requirements
80

ユーザー要件を分析し、システム設計ドキュメント(DESIGN.md)を生成します。ユーザー要件が曖昧または不明確な場合、システムアーキテクチャの設計が必要な場合、大規模な機能開発の設計仕様が必要な場合、技術的実現可能性の検証が必要な場合に使用します。不明点はAskUserQuestionツールで確認します。

writing-tests
80

TDD方法論に従ってテストを作成します。テストファイルの配置(コロケーション)、命名規則、テスト構造のベストプラクティスに従います。React/TypeScript、Go、Rustで適切なパターンを使い分けます。「テストを書いて」「テストを作成」「単体テストを追加」などのリクエストで起動します。

reviewing-skills
80

Claude Codeスキルを公式ベストプラクティスに基づいてレビューします。SKILL.mdファイルのレビュー、スキル品質のチェック、スキル構造の検証、改善提案が必要な場合に使用します。「このスキルをレビューして」「スキル品質をチェック」「SKILL.mdを検証」「このスキルを改善」などのリクエストで起動します。

planning-tasks
80

承認済みの設計書(DESIGN.md)からTDD準拠のTODO.mdを作成します。analyzing-requirementsスキルで設計が完了・承認された後に使用します。developingスキルで実装できる形式のタスクリストを生成します。