コンテンツへスキップ

planning-with-files スキル

長い作業の計画と進捗をファイルに残し、対応フックを使います。

コミュニティ · OthmanAdi
作者OthmanAdi
ライセンスMIT
ソースOthmanAdi/planning-with-files · GitHub 上の SKILL.md
プロジェクトサイトplanningwithfiles.tech
対応環境Claude Code · Codex、Gemini CLI、Cursor、Copilot
ソースを確認した日

planning-with-files: 長い作業の計画と進捗をファイルに残し、対応フックを使います。

v3.28.2 はプロジェクト復元、明示的な履歴読込、任意の制御付き継続を区別します。

スキルの SKILL.md より: # Planning with Files

これは OthmanAdi によるコミュニティスキルで、当サイトや Anthropic による確認は受けていません。スキルはエージェントにコードの実行、ファイルの読み取り、ネットワークへのアクセスを指示できます。インストール前に SKILL.md とフォルダー内のすべてのスクリプトを読み、説明と食い違う動作がないか確認してください。

できること

  1. 対象計画を選び、発見と進捗を保存。

得られるもの

  • Markdown、任意の構造化台帳、復元状態。

使う場面

  • 永続的な文脈が必要な長期作業。

向かない場面

  • 全ホストで同じ停止制御があるとの想定。

必要なもの

  • ローカルファイル、shell/PowerShell、該当 Python 補助。フック対応はホスト次第。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.md入口指示とタスク固有の手順。

2026-11-16 時点でリポジトリに記載されていたライセンス:MIT。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • 永続ファイルで計画して。
  • 選んだ計画だけ復元して。
  • このホストの完了制御を説明して。

planning-with-files のインストール方法

導入準備

正規フォルダー全体とスクリプト・テンプレートをコピー。フックを確認し、発見だけで設定完了と思わないでください。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:スキルフォルダーにフォルダーをコピー

このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。

git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p ~/.claude/skills
cp -R planning-with-files/skills/planning-with-files ~/.claude/skills/

Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /planning-with-files と入力するか、作業内容をそのまま伝えます。

Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。

Codex、Gemini CLI、Cursor、GitHub Copilot

これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:

git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p .agents/skills
cp -R planning-with-files/skills/planning-with-files .agents/skills/
エージェントプロジェクトのフォルダーユーザーのフォルダーメモ
OpenAI Codex
.agents/skills/
~/.agents/skills/
$ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

選択した一つの計画

名前付き選択で無断のタスク切替を防ぎます。ガードは助言で、ロックやマージ機構ではありません。

ホスト能力

旧式・自律・制御モードは異なります。停止を阻止できるフックなしに最強制御はなく、完了保証もありません。

planning-with-files に関するよくある質問

このサイトで実行しますか?

いいえ。出典に基づく導入ガイドです。設定済みのエージェント環境で実行します。

完全なクラウド手順は検証済みですか?

いいえ。汎用アップロードと API 実行手順は省略し、ローカル要件とホスト能力の確認が必要です。

自動で会話履歴を読みますか?

既定はプロジェクト計画のみ。メタデータや限定再生には明示モードと依頼が必要。

検証値は安全な署名ですか?

いいえ。信頼できる保存値がある場合のみ変更を検出し、注入文を安全にはしません。

ほかの AI スキル

関連スキル

スキルのカテゴリー