Claude Codeのスキル設計で最も大事なこと — 決定論的な処理はシェルに逃がせ

スキルを作れば作るほど、壊れるスキルが増えた Claude Codeのスキルを10個ほど作ってきた。記事投稿、壁打ち、ツイート生成、情報収集、画像生成。最初は「スキルさえ作ればAIが全部やってくれる」と思っていた。 現実は違った。同じスキルを実行しても、毎回微妙に違う結果が返ってくる。フロントマターの変換で余計なフィールドが入ったり、ファイルの保存先が変わったり。AIが「良かれと思って」やった判断が、再現性を壊す。 この問題に何度もハマった末にたどり着いた原則がある。 「一つのスキルの中で、決定論的な処理と非決定論的な処理を見極めろ。決定論的な部分はシェルスクリプトに逃がせ。」 ...