🤖

2025年、これが良かったClaude Code開発テクニック

に公開2件

新年明けましておめでとうございます。
年明け早々ですが、昨年の私が「これは良かった」と思ったClaude Code開発テクニックについて、記録に残しておきます。

1. 前提

昨年は会社で使っているSaaSサービスからMarkdownファイルを生成するツールを複数作成していました。
この他にも、Amazon SNSへ送信するメール本文整形LambdaをClaude Codeと一緒に作成しました。

2. Skills

Skillsは良かったです。
最近は「会社で使っているSaaSサービスからMarkdownファイルを生成するツール」を作成していますが、これをSkill化しました。

作成にあたってはAnthropics公式のskill-creatorを使用しました。

新しいCLIツールを開発したときは、最後に振り返りをお願いして、Skillを改善できるか検討しています。
まだ「スラッシュコマンドと何が違うのか」は分かっていないですが、現状での不満はなく、後述のdigで仕様が固まれば、開発は放置で進むようになりました。

3. dig(仕様書の深掘りQAスラッシュコマンド)

Kuuさんが作成したSlash Commandを活用しています。
ファイルを見て質問してくれ、それを元に確定事項を追加してくれるので、非常に便利です。

https://x.com/Fumiya_Kume/status/2005987096457310621?s=20

具体的には、以下のように進めています。

  1. SPEC.md(仕様書)を作成する。自分が思いつく範疇を、ざっくり記載で十分
  2. /digでSPEC.mdを解析。不明点を質問してもらう
  3. 選択肢の中からカーソルキーで選択するか、自由入力欄で回答する
  4. 回答が貯まったらClaudeがSPEC.mdを修正。修正内容を確認する
  5. 自分が満足いくまで、2-4を繰り返す

4. 関数単位のドキュメントリンク

これはLambda開発のときに使ったテクニックです。
Xで見つけたものを活用しています。(出自が見つかりませんでした 汗)
コメント行で、ドキュメントのPathをいれておくと、機能修正の際にClaudeがドキュメントを参照してくれる可能性が高まります。
以下のような感じです。

def lambda_handler(event: Dict[str, Any], context: Any) -> Dict[str, Any]:
    # docs/lambda_handler.md
    """
    メインのLambda関数ハンドラー
    XXXXXのSNSイベントを受信し、Email/Chatbotに転送する
    """
    # 以下、関数の実装

CLAUDE.mdにも、これを守るように指示を入れています。

5. おわりに

この1年でAI業界は大きく進化しました。
2026年はどのようになっていくのかが楽しみです。
今年はAIの力を借りて、業務のルーチン化を進めていきたいと思います。
お読みいただき、ありがとうございました。

Discussion