アマゾン ウェブ サービス ジャパン (有志)Publicationへの投稿
👻

Kiroを使ってZennの執筆効率と品質を改善する

シバタツ
に公開
AI
AWS
Zenn
writing
Kiro
tech

Zennで記事を書くときに、本文はそれなりに書けるとしても、良いタイトルを考えたり、適切なトピックを選ぶことが面倒だったりしませんか？ このようなアシスタント作業はAIに任せて、人間は本文に集中しましょう。

この記事では、Kiroを使ってZennの記事執筆を効率化し、品質を向上させる方法を紹介します。また、Kiroを一度も触ったことのない方が、どのようにKiroを始めれば良いのかを具体例で示した入門ガイドにもこの記事はなっています。

前提条件

  • GitHubリポジトリとZennを連携させている
  • Zenn CLI をインストール済み

上記の準備がまだの方は、以下のガイドに従って事前準備を行ってください。

Kiroを始めよう

プロジェクトを開いてKiroと連携する

Kiroを https://kiro.dev/ からダウンロードして初期セットアップを終えたら Open a project からZennと連携しているGitHubリポジトリのローカルコピーを選びます。

Kiroのプロジェクト選択ダイアログ

Kiroの機能を理解する

左パネルのKiroアイコンを選ぶと以下のような画面となります。それぞれのパネルについて簡単に説明します。

Kiroパネルの概要画面

Specs: 今回は使用しない

Kiroには、チャットから始めて開発を行うVibeモードと、Kiroの大きな特徴の一つである、計画から始めて開発を行うSpecモードがあります。ただし、本記事ではVibeしか使わないため、このパネルは使用しません。

Agent Hooks: 今回は使用しない

ファイルの作成などをトリガーにKiroになにかをさせる機能が Agent Hook です。本記事では使用しません。

Agent Steering: 重要

Kiroに事前に知っておいてほしいREADMEのようなものを定義します。「Steering（操縦）」という名前のとおり、Kiroの回答や行動を適切な方向に導くための仕組みです。他のAI開発アシスタントで言うAGENTS.md / CLAUDE.md / GEMINI.md などと同様ですが、Kiroでは特定のファイルやフォルダーにのみ適用するなど、柔軟な設定が可能です。本記事ではこの設定を主に行います。

MCP Servers

MCP (Model Context Protocol) サーバーを定義します。本記事ではこちらも使用します。

外部リソースにアクセスできるようにする: MCP設定

この後の設定でZennの公式ドキュメントなどの外部サイトを参照しますが、KiroはそのままだとURLを指定しても読みにいかないので、URL先を読みにいけるようになるfetchを使えるようにします。

MCP Servers パネルの右上の📝アイコンを押してエディターを開くと、以下のような設定が自動入力されるはずです。disabledをfalseに変え、autoApproveにfetchを追加して閉じます。Connecting... の表示の後、✅が表示されたら有効になっています。

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "env": {},
      "disabled": false,
      "autoApprove": ["fetch"]
    }
  }
}

KiroにZennの知識を教える: Agent Steering

基本的な知識ファイルを自動生成する

Agent Steering パネルにある Generate Steering Docs ボタンを押すとproduct / structure / techという3つのファイルが作成されます。

すべて英語で書かれているので、中身を読む前にKiroに日本語に翻訳してもらいましょう。ウィンドウ右下のチャットボックスに日本語で依頼します。

Steering内のファイルを日本語に翻訳

プロジェクトの目的を教える: product.md

productには、このプロジェクトの目的 / コンセプト / ビジネス要件を記載します。上の画像のように、KiroはZennについてすでに多少知っているようですが、もっと詳しい前提知識を持ってもらうため、以下を右下のチャットボックスに入力します。

以下のページを参照して #product.md をリファイン
- https://zenn.dev/about
- https://zenn.dev/guideline

MCPサーバーが正しく動作すれば、チャットウィンドウ内に Called MCP tool fetch と表示されます。Kiroがproductを以下のように変更し、Zennがどのようなプラットフォームなのか詳しく記述されました。

一方で、プロダクト概要が Zenn CLI のデモプロジェクトと誤解されています。これは Zenn CLI しかインストールされていないリポジトリを使っていることと、私がリポジトリ名をdemoにしてしまったからでしょう。そのため、ここを修正させます。

プロダクト概要が異なるので、そこだけ修正して。
このプロダクトはZennのコンテンツを管理するために連携しているGitHubリポジトリである。

プロダクト概要を修正後の画面

プロダクト概要が正しくなりました。このように Agent Steering は、人間が最初から最後まで書かなくても、参考文献を渡すだけで良い感じに書いてもらうことができます。

ファイル構造を教える: structure.md

structureには、このプロジェクトのファイル構造やアーキテクチャを記載します。すでに十分な品質なので、このまま使うことにします。

技術的な詳細を教える: tech.md

techには、このプロジェクトの技術的な実装詳細 / ツール / デプロイ手順などを記載します。

Kiroは Zenn CLI については詳しいようですが、ファイル形式については不十分なため、参考文献を渡します。

以下のページを参照して #tech.md をリファイン
- https://zenn.dev/tech-or-idea
- https://zenn.dev/zenn/articles/what-is-slug
- https://zenn.dev/zenn/articles/zenn-cli-guide

ファイル形式・構造について詳しく書かれるようになりました。

さらに詳しい設定を追加する

日本語でやりとりするための設定

Kiroに日本語で質問すると日本語で答えてくれていますが、これを明示的に Agent Steering で定義しましょう。Agent Steering パネル右上の + ボタンを押してワークスペースレベルの新規 Agent Steering をlanguageという名前で作成します。

作成されたlanguage.mdにルールを簡単に記述します。

---
inclusion: always
---

- チャットのやりとりは日本語で行う
- Agent Steering は日本語で記述する

書き終わったら右上のRefineボタンを押します。

だいぶ良い感じにしてくれました。ただ、コミットメッセージは英語が良かったので、そこだけ手動で修正しました。

適切なコミットメッセージを自動生成する設定

適切なコミットメッセージを書くことは退屈な割りに重要なので、Kiroに任せましょう。commit-message-standardsという新規 Agent Steering を作成し、規約は Conventional Commits に従ってもらいましょう。

---
inclusion: always
---

コミットメッセージは [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) に従う。

Refineボタンを押すと以下のようになりました。

悪くはないのですが、fetch MCPサーバーを使用せずに記憶で書いているのと、英語になってしまいました。この点をチャットで修正します。

https://www.conventionalcommits.org/en/v1.0.0/ を参照して、
その内容で #commit-message-standards.md を日本語でリファイン

Zennの記事リポジトリであることを想定した良い Agent Steering ができました。

ZennのMarkdown記法を教える設定

ZennのMarkdown記法はtechに書いてもよいのですが、この記法はarticlesとbooksフォルダー内のファイルにしか適用されず、Agent Steering には適用されないので、念のため別ファイルにして、inclusion:を使って適用範囲を狭めましょう。zenn-markdown-standardsという新規 Agent Steering を作成し、ZennのMarkdown記法一覧 に従ってもらいましょう。

---
inclusion: fileMatch
fileMatchPattern:
  - "articles/*.md"
  - "books/**/*.md"
---

Zennの記事と本のMarkdownは
[ZennのMarkdown記法一覧](https://zenn.dev/zenn/articles/markdown-guide) に従う。

RefineボタンだとURLを参照しないので、直接チャットに以下を入力してリファインします。

https://zenn.dev/zenn/articles/markdown-guide を参照して、
その内容で #zenn-markdown-standards を日本語でリファイン

実際に記事を書いてみよう

これで準備は整いました！ あとは記事を書いていきましょう。まったく違うことを始める場合はコンテキスト（今までのやりとりに基づく知識）をリセットするため、右側のチャットパネルを閉じて、新規チャットを始めるのが良いです。

タイトルとファイルをKiroに作ってもらう

「Kiroを使ってZennの記事の品質を向上させる方法」について書きたい。
お薦めのタイトルは？


「Kiroを使ってZennの記事の執筆効率と品質を改善する方法」にしよう。
適切なslugでファイルを作成して

適切なslugでファイルが作成され、Front Matter も良い感じです。本文まで書いてくれましたが、私はこれを参考にせず、全部消しています。

好みのエディターで本文を書く

このままKiroで本文を書いてもよいでしょうが、私は日常のメモをObsidianで書いていることもあって、Obsidianで書いています。Obsidianの File > Open Vault... > Open folder as vault からGitHubリポジトリを指定しても良いですし、すでに利用している Obsidian Vault があるならば、GitHubリポジトリをそのVault内に移動しても良いでしょう。

Kiroに記事をブラッシュアップしてもらう

本文を書き終えたら、最終調整をKiroに手伝ってもらうことで品質を向上させましょう。

まずは誤字脱字をチェック

誤字脱字を修正して

私はスペースを含む英語と日本語の間には半角スペースを入れているのですが、それが修正されてしまいました。今後のために、これは Agent Steering に含めたほうが良さそうです。

以下を #zenn-markdown-standards.md に追加
- スペースを含む英語と日本語の間には半角スペースを入れる
- スペースを含まない英単語と日本語の間には半角スペースを入れない
- 文末の！と？の後には半角スペースを入れる

このように、「そうじゃないんだよなー」というアシストが行われたときは、都度 Agent Steering に追記していき、Agent Steering を育てていくことが重要です。

読みやすさと構造を改善する

以下では、その他の校正のやりとりの例を挙げます。

あなたが読んで分かりづらかった点を指摘して

どのように修正すべきかも聞いてみましょう。

1についてどうしたほうがよい？

見出しや「まとめ」は本文の概要なので、AIが得意とする領域です。

目次となるように適切に見出しを入れて


最後に「まとめ」を追加して

いざ書いてみると当初の予定からは少しずれているときもあるので、タイトルとトピックを書き終わった後に再検討しても良いでしょう。

本文を読んでみて、より適切なタイトルとトピックがあれば提案して。
今のままで良ければ今のままにしておく


タイトルを「Kiro AI でZenn記事執筆を自動化する」に変更して、
それに合わせてファイル名のslugも変更

完成した記事をコミットする

文章が完成したらコミットしましょう。

新しい記事をコミット

commit-message-standards Agent Steering で定義した規約に従ってコミットメッセージが作成されました。

まとめ

この記事では、Kiroを使ってZennの記事執筆を効率化し、品質を向上させる方法を紹介しました。Agent Steering とMCPサーバーの設定によってKiroに適切な前提知識を与えることで、より精度の高いアシスタント機能を実現できます。また、誤字脱字チェックから構造改善まで、複数の観点で段階的に記事の品質を向上させることができます。このようにKiroに執筆の効率化と品質の改善を任せることで、人間は本文を書くことに集中できます。

補足: 無料枠でどのくらい使える？ クレジット使用量の実例

月間クレジット使用量はウィンドウ右下に表示されています。今回は47.39クレジットから始めて、すべての Agent Steering を作成し終えたときに53.99クレジットだったので、環境構築に6.6クレジット使用しました。コミットしたときには62.86クレジットだったので、一つの記事の校正に8.87クレジット使いました。そのため、校正内容や記事の規模にもよりますが、無料枠の毎月50クレジットで月に5本程度の校正をKiroで行えそうです。初回サインアップから30日間は500クレジットのボーナスがもらえるので、いろいろ試してみてください。無料枠で足りないほど記事を書いたり、Kiroを使いこなしてクレジット消費が多い場合は、月額$20払うと毎月1,000クレジットになります。

Kiroの料金プラン画面。KiroFREE（$0/月、50クレジット）、KiroPRO（$20/月、1,000クレジット）、KiroPRO+（$40/月、2,000クレジット）、KiroPOWER（$200/月、10,000クレジット）の4つのプラン

この記事の動作環境

  • Kiro: 0.5.9
GitHubで編集を提案
アマゾン ウェブ サービス ジャパン (有志)
アマゾン ウェブ サービス ジャパン (有志)Publication

この Publication に投稿している記事は、アマゾン ウェブ サービス ジャパン合同会社または Amazon Web Services, Inc. 所属社員による個人の見解であり、所属する組織の公式見解ではありません。参加したい従業員の方は、Sugiyama Suguru までお知らせください。

Discussion