Claude 公式のブログがめちゃ参考になったので、分かりやすくまとめる。 「Claude は本来めちゃ賢い。でも Skill の書き方を間違えると、実力を自分で潰してる」という話 Claude は基本、かなり賢い前提で設計されている だから人間向けの丁寧すぎる説明とか、背景知識の講義みたいなのを書くと、無駄なトークンが増えて判断精度が落ちるらしい ここがまず重要な前提 Skill って「知識を教える場所」じゃなくて「行動を成功させるための設計図」なんよね。で、よくある失敗がこれ Claude に不安になって、「念のため説明しとこ」「一応ここも書いとこ」ってやると、Skill が太って、コンテキストを圧迫して、結果として性能が下がる 公式が言ってるのはかなりドライで、 - Claude はもう十分賢い - 本当に知らないことだけ書け - 1 トークンごとに価値を疑え という思想。次に出てくるのが「自由度」の話。タスクには性質があって、 - 壊れやすい処理 - 順序や正確さが命の処理 こういうのは、自由度を極限まで下げて「これを、そのまま、絶対にこの順でやれ」と書くべき 逆に、 - レビュー - 分析 - 方針決め みたいなやつは、ガチガチに縛ると逆に弱くなる。このへんは「判断の余地」をちゃんと残す。この自由度設計が、Skill の出来をほぼ決める 公式のたとえが面白くて、Claude を「道を進むロボット」に例えてる。崖だらけの細い橋なら、ガードレール必須。何もない草原なら、方向だけ示して放置でいい Skill はこのガードレール設計の話 あと、めちゃ大事なのが name と description Claude は起動時に、全 Skill の「名前と説明」だけをまとめて読み込む。つまり、 - ここで選ばれなかった Skill は - SKILL .md がどれだけ良くても - 一生読まれない description には『何をするか』だけじゃなく『どんなときに使うか』まで書け、と強調している。ここが弱いと、そもそも Skill 候補に上がらない で、SKILL .md 本体について 全部を書こうとするな、が原則。 SKILL .md は README じゃない。 目次であり、ナビゲーション。 必要になったら、 - reference .md - examples .md - forms .md みたいな別ファイルを読ませる。これが Progressive Disclosure という考え方 ファイルは読まれない限りコンテキストを消費しない、という前提があるからこそ、目次に徹して、必要になった瞬間だけ別ファイルを読ませる設計が効く 全部最初から読ませるのは最悪。必要なときに、必要な分だけ。ただし注意点があって、「参照の参照」はやるな。 SKILL .md → A .md → B .md みたいな構造にすると、Claude が部分読みして事故る SKILL .md から直接リンクする 1 段構造が安全。 次にワークフロー。複雑な作業は、文章で説明するな。チェックリストにしろ。 Claude 自身が「今どこまで終わったか」「次に何をやるか」を自己管理できる形がベスト。 さらに重要なのが、一発成功を前提にするな、という思想 実行 → 検証 → 修正 このループを最初から Skill に組み込む 特に Skill に含める処理については、Claude にコードを生成させるより、あらかじめ用意したスクリプトを実行させる方がいい、と言い切っている 理由は単純で、 - 再現性が高い - 速い - トークンを食わない から。Skill に含めるスクリプトは「生成させるため」じゃなく「実行させるため」に置く あと地味だけど重要なのが、時間依存の情報を書くな。「◯ 年 ◯ 月以降は〜」みたいなのは Skill を腐らせる。古い情報は Old patterns として隔離しろ、という設計 最後に一番思想的なところ Skill は、評価から作れ。 まず Claude が失敗した実例を集める それをテストケースにする それを通すために、最小限の Skill を書く 想像で書いた Skill は、だいたい使われないってことらしい まとめると、このページが言ってるのはこれ - Claude を「何も分かってない新人」として扱うな - 「めちゃ優秀だけど、事故るときは事故る同僚」として扱え - Skill は知識集じゃない。判断ミスしやすい場所にだけ置くガードレール

Claude Code の ルーティン（PCを閉じた状態でもクラウド上でClaude Codeを自動実行）を使って本番エラーを毎朝 Discord に届ける仕組みをまとめました！ izanami.dev/post/27cf908f-64…

【お詫び】izanami で 10/9〜10/17 の間、画像のアップロードが反映されない不具合がありました🙏 現在は修正済みです。 この期間に記事やプロダクトの画像をアップロードした方は、お手数ですがもう一度アップロードをお願いします。 ご報告いただいた方、ありがとうございました！ izanami.dev

おぉ！IPAとJPCERT/CCの不正アクセス注意喚起をもとにした緊急点検のスキル化、いいですね。外部公開アプリ・外部サービス・保有データの点検に加えて、インシデント対応体制もチェックできるぞぅ

IPAの不正アクセス緊急点検リスト。公開アプリ+外部サービスを部署単位まで洗い出し、直近1ヵ月からログ確認。エラー量やログイン元IP・時間帯を平時と比べ、不審アカウントや停止アカウントの復活を点検。未適用パッチは即適用。異常は即インシデント扱いで専門ベンダーへ ipa.go.jp/security/security-…

シニアエンジニアの開発の進め方を守らせるためのスキル集。チームでAI開発の品質基準をそろえたい人にいいかも。開発ライフサイクルは、定義→計画→実装→検証→レビュー→リリースって感じで実にいい

バイブコーディングの盲点。AIコーディングさせたサイト、別のMacで見るとアニメーションが全滅。原因はOSの「視差効果を減らす」設定ON。Claude Code がアクセシビリティの作法に従って、動きを止める処理を全部に入れてた。作法でも、出し分けは先に質問させたほうがいいね

これは楽しみ！AIで作るのは一瞬なのに、チェックする人間の時間は全然縮まらないんだよね…ってモヤモヤしてる人によさそうだ

これ、新人研修にかなり向いてるね ネットワークの基礎を、Linuxを実際に動かして学べる入門教科書（76ページ）が無料公開。基本から入れて実務につながるし資格取得にも進みやすい。2〜5日の研修にちょうどいい分量だよね lpi.or.jp/news/press/page/20…

海外にプロダクトを広げたい開発者いますか？ 私、15年以上SEO保守やっていて、AEO商談も８月だけで20件ほどあり、海外も伸ばせるかと izanami を海外展開しようかなと考えています 登録プロダクトが英語圏の検索やAI回答にも出てくるイメージ 広げたい人リプください izanami.dev/products

[節約実験] 文章を AI にチェックさせるとき、63件×27問を Jev・Sonnet・Opus で判定した。白黒つく質問の多くは、費用100分の1の Jev で Opus とほぼ同じ答えが出た。迷った分だけ Sonnet に回せばOK（数字は Opus との一致率）

AIエージェントでコード脆弱性探しを効率化したい方々、google/mantis よさそう。脆弱性自動検出→再現→修正。コード履歴から過去の脆弱性を洗い出して同じミス防ぐのと脆弱性精査してハルシネーション対処する点いいね。※隔離環境で使うことと結果を人が確認すること前提 github.com/google/mantis

既存Next.jsをほぼそのまま移せる Vinext 正式版きた！ めっちゃいいやん Cloudflare Workers（無料プラン含む）にもデプロイできるぞう 目玉のキャッシュウォーミング → 公開直後、高速応答。ページ数カオスで、ビルド長えって悩んでいるサイトには特に良さそう！ blog.cloudflare.com/vinext-n…

Claude Code、Sonnet 5.5 と Opus 5.5 の使い分け バグ修正や機能の小さな手直しは Sonnet 5.5 資料・スライド・スプレッドシートの作成も得意、デザインセンスある 長丁場で判断が要る仕事は Opus 5.5 デフォルトは Opus 5.5 のまま、/model sonnet で切り替え claude.dev/blog/building-wit…

Claudeスキル、モデル賢くなってきたから、これおすすめ ↓ スキル説明は短く。何をするかといつ使うかは入れる ↓ 詳細は別ファイルへ。本体にはいつ開くかだけ ↓ 細かく書かない。制約値・バージョンは残す ↓ 禁止より理由を書く ↓ 壊れやすい手順だけ厳密に ↓ 権限と完了条件は明示 → 駄目ならスキルなしと比較。なしが勝てば全消し