agentleFS
Sign inStart free
ktaroabobonktaroabobon/agent-skills/skills/sanitize-artifacts/SKILL.md

sanitize-artifacts

Skill0 starsChanged 3 months agoMITView on GitHub

会話の中で作った成果物(ドキュメント・コード・コメント・PR 本文・UI 文言)から、指示の引用・採用しなかった案・制約の免責文・修正経緯といった制作過程の残滓を取り除き、読み手だけを見た自立した形に仕上げる。「成果物を整えて」「会話の痕跡を消して」「そのまま渡せる形にして」「仕上げて」「sanitize して」「メタ情報が混ざってないか見て」時に使用。内容の追加や技術的な変更はしない。修正後の成果物そのものを返し、作業報告は求められたときだけ添える。

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Create a free account to mount
Files
SKILL.md

sanitize-artifacts

会話の中で作った成果物を、会話を見ていない読み手のために仕上げる。対象はドキュメント、コード、コメント、コミットメッセージ、PR 本文、UI 文言など、人に渡るものすべて。

原則

会話は制作の文脈であって、成果物の内容ではない。

ユーザーの指示・例示・制約・修正依頼は、成果物の構成・語調・既定値・省略を決める材料として使う。成果物に文として残すのは、読み手が本当に必要とする内容だけ。残滓が無ければ何も変えず、「変更なし」と報告して終わる。

引数

  • path ...: 対象ファイル。省略時は、この会話で作成・編集した成果物を対象にする

Step 1: 残滓を見つける

対象ファイルに同梱スクリプトを当て、表層パターンの当たりを付ける:

bash ${CLAUDE_SKILL_DIR}/scripts/find_residue.sh <path ...>

(Codex ではスキルディレクトリからの相対パスで bash scripts/find_residue.sh と実行する)

スクリプトは発見の補助で、判定はしない。当たりが 0 件でも本文を通読する。 文章の継ぎ目、唐突な免責、読み手に関係ない前置きは grep では見つからない。

種類表層パターンの例
指示の引用「ご要望どおり」「ご指示のとおり」「ユーザーの指示により」「As requested」「Based on your instruction」
採用しなかった案「今回は〜しない」「〜は使わない」「〜を避けるため」「Unlike the previous version」「This avoids」
制約の免責「制約があるため」「本書では〜を扱わない」「No Git/CLI is used」「Because of the constraint」
修正経緯「〜に変更しました」「前のバージョンと違い」「この節は〜のため追加」「This was changed to」
会話への参照「先ほどの」「上記の要求」「会話の中で」「The prompt says」

Step 2: 分類する

見つけた記述と、成果物の各部分を、次のどれかに分類する。分類してから手を入れる。 個別に「消す / 残す」を決めると基準がぶれる。

分類扱い
1. 読み手が本当に必要とする内容そのまま残す
2. 成果物の設計には影響すべきだが、見えてはいけない文脈構成・語調・既定値・例の選び方に反映し、文としては消す
3. 会話の残滓消す

判断に迷う記述は「読み手が会話を知らなくても、この一文を読んで得をするか」で決める。得をしないなら 2 か 3。

Step 3: 制約を設計に溶かす

2 に分類したものは、免責文ではなく設計として成果物に反映する。

✗ 漏れている⭕ 溶けている
「本ガイドでは Git や CLI ツールは使いません」「プロジェクトフォルダは Google Drive で共有する」
「X については触れません」X が無い構成にする
「初心者向けに平易に書きました」用語を定義し、手順を細かく刻む
「ご指摘を受けて並び順を変えました」最初からその順だったように書く
「高度な用語は避けます」平易な語で書く

会話中の例は意図を読み取るための材料であり、成果物に写す内容ではない。成果物自体がその例を必要とする場合だけ残す。

Step 4: 通して読み直す

手を入れた後、読み手になったつもりで最初から読む:

  • 会話を見ていない人が、なぜこう書かれているのか疑問に思う箇所は無いか
  • ツール・除外・回避した選択肢への言及は、読み手に必要なものだけか
  • 複数回の修正の継ぎ目(語調の揺れ、重複、矛盾する前提)は無いか
  • 見出しと注記は、作り手ではなく読み手に向いているか
  • 免責・注意書きは、読み手が本当に必要とするものだけか
  • 全体が 1 つの声で書かれているか

最後にもう一度 find_residue.sh を当て、残りが「残すと決めたもの」だけであることを確認する。

やらないこと

  • 成果物の目的・技術的な正しさ・読み手向けの要件を変えない
  • 新しい内容を足さない。削る・言い換える・並べ替えるまで
  • 表層パターンに当たったものを機械的に消さない。読み手に必要なら残す

完了時に返すもの

修正後の成果物そのものを先に出す。 「〜を削除しました」「こちらが修正版です」のような前置きは付けない。

  • ファイルを編集した場合: 編集したファイル名だけを 1 行で
  • 成果物をそのまま返す場合: 成果物本体のみ。ラベルが要るなら 1 行まで
  • 変更が不要だった場合: 「変更なし」と、通読した範囲
  • 変更のサマリは求められたときだけ、成果物の後に付ける

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free