Claude Code の Memory, Subagent, Skills で再現性高く効率的に作業を進める

llm

Claude Code には、毎回の指示や LLM の判断に頼らず、再現性高く効率的に作業を進めるための仕組みがいくつかある。Memory はセッション間で知識を保持する。Subagent はタスクを特化したエージェントに委譲しコンテキストを分離する。Skills は指示セットを定義して再利用可能にする。Hooks はライフサイクルイベントに連動した処理を確実に実行する。

Claude Code の Hooks で –dangerously-skip-permissions での危ない操作をブロックする - sambaiz-net

Memory

Memory はセッション開始時に読み込まれるファイル群。コードから推測できない情報だけを簡潔に書くことが推奨されている。CLAUDE.md をプロジェクトルートに置くとチームで共有でき、~/.claude/CLAUDE.md は全プロジェクト共通の個人設定、./CLAUDE.local.md はプロジェクト固有の個人設定として使える。CLAUDE.local.md は Claude Code が .gitignore に自動追加する。/init でプロジェクト構造に基づいた雛形を生成できる。

# Project

Tech blog built with Hugo.

## Commands

- Build: `hugo`
- Dev server: `hugo server -D`

## Rules

- Create articles at `content/article/{number}/index.md`
- Always specify language in code blocks

.claude/rules/ にはパス条件付きのルールを置ける。

<!-- .claude/rules/testing.md -->
---
paths:
  - "tests/**/*.test.ts"
---

Use Jest. Maintain 80%+ coverage.

Subagent

Subagent は独自のコンテキストでタスクを実行し、結果のサマリのみを返す。大量の出力を分離し、メインのコンテキストウィンドウを節約できる。組み込みエージェントとして、Haiku で動作するコードベース探索用の Explore、プランモードでの調査用の Plan などがある。

<!-- .claude/agents/security-reviewer/SKILL.md -->
---
name: security-reviewer
description: Review code for security issues
tools: Read, Grep, Glob
model: sonnet
---

Check for SQL injection, XSS, and authentication issues.

ツール権限はデフォルトで継承されるが、Skills と親の会話履歴は渡されない。ツールは Read, Write, Bash など Claude Code が操作を行うための組み込み機能で、MCP で拡張できる。Subagent の起動も Task ツールで行われる。

MCP で Todoist にタスクを登録する - sambaiz-net

Skills

Skills は指示セットを定義したもの。Memory が常に全文読み込まれるのに対し、Skills は description のみがコンテキストに入り、呼び出し時に全文が読み込まれる。/skill-name で直接呼び出すこともできる。 $ARGUMENTS は呼び出し時の引数に、!command は実行結果に置換される。オープンな仕様になっていて Codex や Gemini CLI など他のツールも対応している。

<!-- .claude/skills/deploy/SKILL.md -->
---
name: deploy
description: Deploy application
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy to $ARGUMENTS environment.

Current branch: !`git branch --show-current`

1. Run tests
2. Build
3. Run deploy script

Vercel が運営する skills.sh というサービスがあり、npx skills add でインストールできる。Claude Code 専用の配布形式として Plugins もあり、Skills に加えて Agents, Hooks, MCP サーバーをバンドルしたものを /plugin install でインストールできる。