はじめに

Coding Agentに仕事を渡すための土台

Coding Agentを継続的に使い、業務を改善していくためには、「AIがわかりやすい形であなたの指示を保存する形式」と「一連のフローをレシピとして保存しておく仕組み」を最低限理解しておくことが重要です。

Coding Agentの世界は日夜発展しており、常にキャッチアップしていく必要があります。一方で、情報量が非常に多いため、すべてを追い続けるのは簡単ではありません。それでも、以下で紹介する知識・スキルは、この1年間を通して"土台"に近いものになってきました。まずは最低限、以下の2つを理解していきましょう。

Markdown

Markdown は、文章を見出し、箇条書き、コードブロック、引用、表などで構造化するためのフォーマットです。Coding Agent に仕様書や手順を渡したり、作業ログを残したりするときの基本になります。

「AIに読ませるための文章」を書くうえで、Markdown は最初に押さえておきたい共通言語です。

Skills

Skills は、Agent に「どう仕事を進めてほしいか」を教えるための仕組みです。例えば「PRレビューをする」「ブログ記事を書く」「データ分析を行う」「メールを整理する」など、ある程度定型化された仕事には、毎回使う手順や判断基準があります。

PR(Pull Request)レビューとは、コードを管理するGitHub上で、他の人が加えた変更を公開・反映する前に確認する作業です。文章でいえば公開前の校正に近く、「意図した内容になっているか」「問題が起きそうな変更がないか」「あとから困らない形になっているか」を確認します。

Skills を使うと、そうした手順や判断基準を再利用可能な形でまとめられます。Skillsのセクションでは、合わせて外部ツールと連携する方法についても解説をしていきます。