本文へ移動
cccskills
無料GitHub で公開

refactor-context

指定スコープの instruction / agent / skill をコンテキスト最適化する。単一ファイルも複数ファイル群の MECE 横断レビューも扱う。構造レビューは review-workflow-structure の担当

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.6 KB
  • LICENSE.txt5.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

<!-- syncToGlobal: true --> <!-- author: aktsmm --> <!-- repository: https://github.com/aktsmm/Agent-Customization --> <!-- license: CC BY-NC-SA 4.0 --> <!-- copyright: Copyright (c) 2025 aktsmm -->

refactor context

When to Use

  • 使う: 単一ファイル内のコンテキストを圧縮・整理
  • 使う: 複数ファイル群を横断して SSOT / DRY / SRP / MECE / スコープ適合を見る
  • 使わない: SKILL 本文の設計、新規 agent / workflow の scaffold

モードとスコープ

  • モード: 自動 / オート / auto 含む → オート(不可逆・影響大は提案止まり)。それ以外は確認モード
  • スコープ: 指定なし は対象のみ / ALL / Global (=~/.copilot/ の instructions・skills・agents) / ALL + Global
  • 対象外(明示指定なき限り): .github/skills/, .vscode/settings.json
  • スコープ境界: Global 対象は ~/.copilot 内で完結させる。明示許可なしに現在の workspace / repo へ移動・分割・SSOT 化を提案しない
  • 現在 workspace は参照情報としてだけ使う。配置先提案の既定にしない

判断ルール

目標: 対象ファイルを AI が判断できる最小情報に圧縮する。人間向け可読性は二次

  • 削除を先に判定し、必要な残りだけを圧縮する。記述なしでも正常・例外・停止時の判断が変わらない一般論 / 自明な説明 / 装飾 / metadataの言い換え / 重複 / 役割が消えた節 / 無効なルール・exampleは、短く言い換えて残さない
  • 残す: 判断に必要なユーザー固有事実 / ID / パス / 方針、参考 URL・判断に効く設計根拠、Example(最低 1 つ)、非自明な手順。具体的な失敗条件・引数・承認範囲・未検証要件・停止・復旧手順は自明扱いせず残す
  • 圧縮: 必要だが冗長な定義・前置き・エラー例。統合済みの重複を削るときは、許可スコープ内の参照先と実際の読み込み経路で同じ判断が成立することを確認する
  • 履歴: 古さだけで削除しない。現行判断に不要で原文の保存を確認できた履歴は削除候補にし、必要なら固定リビジョン等の再取得先だけ残す。未保存の追記は保存を確認するまで保持する
  • 削除禁止: 運用メタコメント(syncToGlobal / author / repository / license / copyright)

レビュー観点

  • SSOT / DRY / SRP / スコープ適合
  • applyTo / 常時ロード / 手動呼び出しの整合
  • agent は本文の tool reference が frontmatter tools と整合しているか(不一致は lint エラー)
  • 適用範囲・ルーティング(いつ使う / 使わない / どこへ逃がす)が、見出しだけに依存せず各ルールで明確か
  • 意味保持: 主語・対象・適用条件、必須/任意、優先/禁止、例外、停止・検証条件を変えていないか。統合で対象を意図せず広げない(例: script不在の実行停止を新規ファイル作成禁止へ広げない)。意図した挙動変更は圧縮と区別し、承認範囲を確認する
  • 判断の整合: 経路選択 → 実行 → 検証 → 停止がつながり、後続ルールが先に選んだ経路や制約を覆さないか
  • Global 対象の逃がし先は ~/.copilot の instruction / agent / skill に限る。workspace へ逃がす案は「明示許可が必要」と書く

複数ファイル時のみ追加:

  • MECE: 同じ概念の重複定義なし / 想定タスクに空白なし
  • 配置適合(always-on / scoped / 手動参照)
  • 逃がし先有効性: 対象スコープ内の applyTo 付き instruction / 明示呼び出し型 agent・skill / references のいずれか。不可: 別スコープへの移動・参照リンク(明示許可がある場合を除く)
  • ファイル提案順序: 削除(役割消失 / 重複) → 既存への統合 → 既存ファイル内の整理 → 分割 → 新規追加。新規ファイルは最後の手段
  • Global 対象のファイル提案順序: Global 内で削除 → Global 既存へ統合 → Global 既存内で整理 → Global 内で分割 → Global 新規追加。workspace 化は提案順序に含めない
  • ファイル削除は破壊的なのでオートモードでも提案止まり

手順

  1. 対象全件の全文で削除候補を先に判定し、必要な残りを圧縮する。直近の変更節だけで評価しない。Before→After を提示(文字数は改行を同じ条件で計測し、行数/見出し数も示す)
  2. 文字数・行数は補助指標とし、短くても曖昧さ・矛盾・重複をレビューする。明確な問題がなければ変更不要
  3. 適用は 1 ファイルずつ
  4. 適用後は原文と変更後で、対象に該当する正常時・例外時・停止時の代表入力に対する判断を比較する。意図しない差を修正し、キーワード残存だけで合格にしない。複数ファイル時は MECE(重複消失 / 空白未増)も確認

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

Design, review, and debug agent workflows, and decide when a request should use a prompt, instruction, skill, agent, or hook before escalating to multi-agent design. Use for .agent.md / .instructions.md / .prompt.md / AGENTS.md work, workflow architecture, orchestration planning, scheduled automation model allocation, or when agent workflows may be overkill. Triggers on 'agent workflow', 'create agent', 'automation models', 'ワークフロー設計', 'orchestrator'.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

Design, run, and review fair performance, token, and cost comparisons across GitHub Copilot CLI, Codex CLI, and direct model APIs. Use for AI CLI benchmark, Copilot vs Codex, prompt-cache diagnosis, cache read/write analysis, fresh-process latency measurement, token-cost comparison, or when a benchmark must separate provider caching from local CLI caches.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

Analyze historical VS Code GitHub Copilot Chat sessions by model, reasoning effort, AIU, time, reliability, workflow behavior, and external quality evidence, or safely prune workspace-scoped local chat history by age. Use for session analysis, repeated-task retrospectives, model evaluation, cost/performance analysis, and old session cleanup.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

Create reproducible animated infographic GIFs from structured data or measured results, with audience-language labels, explicit timing semantics, representative-frame QA, and a static fallback. Use when asked for GIF生成, animated infographic, 動的インフォグラフィック, 結果が流れる図, animated benchmark, or a blog/SNS animation whose displayed metrics must remain traceable to source data.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

archify

無料

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid. Also use for Archify, interactive or animated HTML diagrams, インタラクティブ図, 動く構成図. When an editable .drawio file is required, use the draw.io workflow instead and treat Archify HTML only as a supplement.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

Generate ASCII-art text banners for terminals, READMEs, and CLI startup messages. Use when a user asks for an ASCII banner, text art, バナー, アスキーアート, or a decorative header for a script/README.

日本語の概要は準備中です。原文の説明を表示しています。

aktsmm/Agent-Skills262026年10月18日 更新

aktsmm のスキルをすべて見る

このスキルの問題を報告する