Mikuku-authored Note article packages and source materials.
Articles are organized by year, month, and date under paths such as
2026/06/20260607/. Each article package may include the article Markdown,
published-image assets, and image-generation source prompts.
Some draft articles compare how an AI agent searches this repository before and after adding generated indexes. Those experiments use a local raw clone as the reference corpus.
After checking out this repository, prepare the raw corpus from the repository root:
mkdir -p references/raw
git clone https://github.com/igapyon/mikuku-articles.git references/raw/mikuku-articlesIf references/raw/mikuku-articles already exists, update it instead:
git -C references/raw/mikuku-articles pull --ff-onlyreferences/raw/ is local working data and is ignored by Git. Do not commit the
raw clone.
公開済み記事を追加または更新して README.md の記事一覧を変更するときは、
同じ作業で note 記事一覧 の
該当カテゴリも更新してください。逆に、note 記事一覧を変更するときも
README.md の「記事をテーマ別に読む」と「全記事一覧」を同期してください。
両方の Markdown を更新した後、リポジトリ指定の miku-indexgen を実行して
index.json を再生成します。
記事はテーマ別に分類しています。各分類内では、新しい記事からチェックできるように日付の降順で並べています。
- 2026-06-07: 生成AI 省トークン考察 2026年6月版（OpenAI系を題材に） (note)
- 2026-05-31: Agent Skills でトークン消費量を抑える考え方 (note)
- 2026-05-31: 生成AIのトークン消費量を抑える考え方 (note)
- 2026-05-30: 生成AIとトークンの基本 (note)
生成AI agent の周辺技術を「妖精さん」「魔法陣」「魔法書」の比喩で読む三部作です。確認順は新しい順、物語としての読み順は 2026-06-03 から 2026-06-06 です。
- 2026-06-06: 生成AI agent の向こう側には、いろいろな妖精さんがいる (note)
- 2026-06-05: 生成AIの MCP は、妖精さんへお願いする魔法陣に近い (note)
- 2026-06-03: 生成AIの Agent Skills は魔法書に近い (note)
- 2026-07-21: [miku-ai-assistant-builder] 開発日誌：AI assistant 登録作業をちょっと楽にする Agent Skill を作ってみました。 (note)
- 2026-07-17: [miku-text-bundle] v1.5.1までの開発日誌：handoffからKnowledge sourceへ (note)
- 2026-07-16: 開発日誌：プロンプトをレビューする Agent Skill をつくってみた。 (note)
- 2026-07-08: miku-soft 開発日誌：Markdown から Office への出口を、テンプレート適用で少し強くする (note)
- 2026-05-29: miku-grep 開発日誌：AI agent に選ばれる CLI をそっと考察中 (note)
- 2026-06-25: GOAL運用する Agent Skill を作ってみた (note)
- 2026-06-24: GPT-5.5とQwen3-Thinkingでは、プロンプト / Agent Skills 像が違って見える (note)
- 2026-06-22: AIエージェントの状態管理、まずは GOAL.md・TODO.md・DECISIONS.md から試してみたい (note)
- 2026-05-29: Agent Skills による開発資産の発芽成長 (note)
- 2026-05-26: Agent Skill を作っていて、BASIC とマシン語を思い出した (note)
- 2026-05-23: コンテンツ型 Agent Skill にはどんな種類があるか (note)
- 2026-05-16: コンテンツ型 Agent Skill を活用してみる (note)
- 2026-05-14: Agent Skills 開発入門：自然言語でプログラミングするという考え方 (note)
- 2026-05-09: Agent Skills の発火は、どのように起きているのか (note)
- 2026-05-09: Agent Skills では、説明ページの役割が少し変わる (note)
Agent Skills を簡易RAG風に育てていく実装寄りの連載です。step1 から順に読むと、擬似RAG、索引、蒸留 Markdown の流れを追いやすくなります。
- 2026-06-20: 簡易RAG風Agent Skillsの作成 step3：蒸留 Markdownで意味の地図を作る (note)
- 2026-06-17: 簡易RAG風Agent Skillsの作成 step2：miku-indexgenを足す (note)
- 2026-06-15: 簡易RAG風Agent Skillsの作成 step1：はじめまして擬似RAG (note)
Mermaid、Markdown、アジャイルなど、生成AI時代にも土台として読んでおきたい基礎知識や開発の考え方です。
- 2026-06-26: Playwright を、WebテストとAI agentの入口として、そっと見てみる (note)
- 2026-06-14: 生成AI時代の既存システムのドキュメント作成：ソフトウェア考古学で仕様メモを蒸留する (note)
- 2026-06-11: 生成AI時代のアジャイル：4つの価値に起きるパラダイムシフト (note)
- 2026-06-09: アジャイルソフトウェア開発宣言からはじまるアジャイル入門 (note)
- 2026-06-04: Mermaid から入る UML 入門：図からクラス図・シーケンス図・状態遷移図をちょっと理解 (note)
- 2026-05-16: Markdown 入門は、まず GitHub 風 Markdown から始めたい (note)
- 2026-07-07: 専門ツール、ちょっと苦しくなくなるかもしれません：Codex と DaVinci Resolve で生成AI時代の動画制作を体験 (note)
- 2026-06-13: AI agent は速読する：しくみを知ってうまく付き合う開発スタイル (note)
- 2026-06-12: 生成AIとの付き合い方：人間同士の会話の力学を少し応用する (note)
- 2026-06-08: Microsoft Copilot のことを少し調べてみた (note)
- 2026-06-01: 生成AIモデルの仕組み入門：トークン、ベクトル、Attention、学習 (note)
- 2026-05-30: 生成AIは、なぜこんなに親しみやすい価格帯で使えてしまうのか (note)
- 2026-05-28: AI agent とキャラクター人格で技術エッセイを書くということ (note)
- 2026-05-27: OpenAI / Codex の UI を、公式名称と自分の理解に分けて整理してみる (note)
- 2026-05-27: AI agent は、全部読まないのに、なぜ開発できるのか (note)
- 2026-05-15: 生成AI時代のアプリは、AIが理解・変更・検証できる単位に分ける (note)
- 2026-05-14: AI-native CLI / MCP / Agent Skills 設計メモ：AI が呼びやすいツールになるよう最初から設計する (note)
- 2026-05-14: 生成AI開発まわりの “Engineering” を整理してみる (note)
- 2026-05-10: MCP は、生成AIに道具を渡すための入口になる (note)
- 2026-04-30: 生成AI agent と開発するとき、README・docs・TODO は会話の外の記憶になる (note)
- 2026-04-28: 生成AIと長く話していたら、日本語の使い方が少し変わってきた (note)
2026-07-03 の miku-ms-office-skills 紹介記事から、Word / PowerPoint /
Excel と Markdown の相互変換を扱う miku-soft シリーズが続きます。
- 2026-07-06: [miku-md2xlsx] MarkdownをExcelへ変換する小さな道具 v0.6.6 (note)
- 2026-07-06: [miku-xlsx2md] ExcelをMarkdownへ変換する小さな道具 v1.3.0 (note)
- 2026-07-05: [miku-md2pptx] MarkdownをPowerPointへ変換する小さな道具 v0.2.2 (note)
- 2026-07-05: [miku-pptx2md] PowerPointをMarkdownへ変換する小さな道具 v0.5.1 (note)
- 2026-07-04: [miku-md2docx] MarkdownをWordへ変換する小さな道具 v0.9.2 (note)
- 2026-07-04: [miku-docx2md] WordをMarkdownへ変換する小さな道具 v1.2.1 (note)
- 2026-07-03: MS OfficeファイルをMarkdown化するOSSのAgent Skillsをつくってみました (note)
- 2026-05-16: [miku-text-bundle] 複数のテキストファイルを生成AI向け Markdown bundle に整理する (note)
- 2026-04-28: [miku-indexgen] AI にファイルを読ませる前に、まず地図が欲しかった話 (note)
- 2026-04-12: [miku-abc-player]
ABC記譜法の譜面を、ちょっと五線譜で見たくなった (note) - 2026-04-12: [mikuscore-skills] 生成AI に譜面対応させたくて、まず ABC 記譜法に寄っていった話 (note)
- 2026-04-10: [mikuproject] WBS 作成を生成AIに手伝ってもらったら、思ったより幸せだった話 (note)
- 2026-03-30: [mikuproject] 生成AIと小さなツールを組み合わせたら、WBS の叩き台が意外とすんなりできた話 (note)
- 2026-03-30: [mikuproject] 作業を分けて並べた計画表を毎回ちがう形式で扱っているのが、だんだん気になってきた話 (note)
- 2026-03-27: [xlsx2md] 設計書の取り消し線が Markdown で消えると、ちょっと危ない (note)
- 2026-03-26: [xlsx2md] Excel 方眼を Markdown にする記事を書こうとしたら、およよとなった話 (note)
- 2026-03-20: コードを書かずに、生成AIと一緒にアプリを作ってみた (note)
Current article packages are listed in 記事をテーマ別に読む and 全記事一覧.
Supporting documentation:
docs/repository-overview.md: repository overview and current article theme.docs/note-article-import-procedure.md: procedure for importing Note articles.docs/root-index-maintenance.md: how to update rootindex.json.
Generated root index:
index.json
The root index is generated by miku-indexgen. Do not edit it by hand.
2026/
YYYYMMDD/
YYYYMMDD-article-slug.md
images/
000.jpg
001.jpg
src/
image-prompt.md
sections/
docs/
index.json
README.md
The exact image file names may differ by article. For example, the 20260606
article uses u000.png style names, while the 20260605 article uses 000.jpg
style names.
Article Markdown files should follow this front matter shape:
---
title: 記事タイトル
tags: #生成AI #MCP #AIagent #PromptEngineering #mikuku
author: igapyon
published_to: note
writer_agent: みくく
url: https://note.com/toshikiigaa/n/example
release_date: YYYY-MM-DD
---After front matter, place the article title as an H1, then the cover image:
# 記事タイトル
See docs/note-article-import-procedure.md for the full import procedure.
Run this from the repository root after adding or changing articles or docs:
java -jar /Users/igapyon/.codex/skills/igapyon-miku-indexgen/runtime/miku-indexgen-1.6.2.jar \
--input-directory . \
--output-directory . \
--title "mikuku-articles"This updates index.json.
See docs/root-index-maintenance.md for maintenance details.
- Do not commit
.DS_Store. - Use
workplace/as a local scratch area for generated files, external clones, and verification artifacts. Git tracks onlyworkplace/.gitkeepthere. - Do not manually edit generated
index.json. - Keep image-generation prompts under each article's
images/src/directory when they are part of the article package. - Commit article Markdown, images, prompt sources, docs, and the refreshed root index together when they belong to the same import or maintenance task.