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
できること
- 対象計画を選び、発見と進捗を保存。
得られるもの
- 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 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
選択した一つの計画
名前付き選択で無断のタスク切替を防ぎます。ガードは助言で、ロックやマージ機構ではありません。
ホスト能力
旧式・自律・制御モードは異なります。停止を阻止できるフックなしに最強制御はなく、完了保証もありません。
planning-with-files に関するよくある質問
このサイトで実行しますか?
いいえ。出典に基づく導入ガイドです。設定済みのエージェント環境で実行します。
完全なクラウド手順は検証済みですか?
いいえ。汎用アップロードと API 実行手順は省略し、ローカル要件とホスト能力の確認が必要です。
自動で会話履歴を読みますか?
既定はプロジェクト計画のみ。メタデータや限定再生には明示モードと依頼が必要。
検証値は安全な署名ですか?
いいえ。信頼できる保存値がある場合のみ変更を検出し、注入文を安全にはしません。
ほかの AI スキル
関連スキル
free-tools スキル
コミュニティ · Corey Haines無料ツール案を利用価値、事業適合、維持費で評価します。site-architecture スキル
コミュニティ · Corey Haines階層、ナビゲーション、URL、役立つ内リンクを設計します。n8n セルフホスティング スキル
コミュニティ · Romuald CzłonkowskiDocker版n8nをデプロイ・保守し、Caddy HTTPS、非公開サービス、検証済みバックアップを整えます。n8n Code JavaScript スキル
コミュニティ · Romuald Członkowskin8n JavaScript Code ノードの入力と戻り値を実行モードに合わせて作成・修正します。n8n Code Python スキル
コミュニティ · Romuald Członkowskin8n 2.x Code ノード向けに、サンドボックスと実行モードの制限を踏まえた Python を書きます。n8n Code Tool スキル
コミュニティ · Romuald Członkowskiquery 入力と文字列出力を持つ、エージェント用 n8n Custom Code Tool を作ります。