igapyon-note-writer

Files (3)

• SKILL.md
• note-markdown-table-images.md · references/
• general-note-article-template.md · templates/

SKILL.md (first lines)

# igapyon-note-writer

Note 媒体に掲載する、みくく担当の技術エッセイを管理・整形するための補助 skill です。

この skill は、Note っぽい日記文や柔らかい読み物文体を作るためのものではありません。本文の基本的な語り手、温度感、みくくとしての話法は、主に `igapyon-mikuku-agent` 側の規則に従います。

この skill の主な役割は、Note 掲載用の正本 Markdown、掲載メタデータ、ハッシュタグ、公開状態、公開時の補助工程を扱うことです。

## Purpose

この skill では、次の作業を扱います。

- Note 掲載用 Markdown 正本の作成・整理
- Note 掲載用 front matter または既存掲載情報の整備
- Note 用タイトル案とハッシュタグ案の作成
- 公開 URL、下書き状態、掲載状態の管理補助
- みくく担当の技術エッセイを Note 掲載用に整えること
- 既存 Note 正本の流れ、段落、掲載情報の確認
- Qiita など別媒体向け原稿から、共通する事実差分だけを Note 正本へ移すこと
- Note 公開時のグラレコ画像生成工程への案内
- Note の表示制約に合わせた Markdown 表の画像化工程への案内

本文の主担当は、基本的にみくくです。`igapyon-note-writer` は、みくく文体そのものを詳細に定義し直すのではなく、Note 媒体に載せるための管理・整形・公開補助を担当します。

## When To Use

次のような依頼では、この skill を使います。

- `igapyon-note-writer` が明示されたとき
- 「Note に掲載する記事として整えて」
- 「note 用のメタデータを作って」
- 「Note のハッシュタグを考えて」
- 「Note 正本として保存・更新して」
- 「Note 公開前に掲載情報を確認して」
- 「みくく担当記事を Note に出す形にして」
- 「Qiita ではなく Note 側の正本へ反映して」
- 「Note 用に Markdown の表を画像化して」
- 「Note で表が表示できないので画像にして」

次の依頼では、この skill を無理に使いません。

- Note 掲載やこの skill が明示されていない一般的な文章校正
- Note 掲載や正本管理が関係しない短文投稿
- 純粋な API 仕様、CLI 手順、コマンドリファレンスの作成
- Qiita front matter の作成
- みくく文体だけを整える依頼

みくく文体だけが必要な場合は、`igapyon-mikuku-agent` 側の文章執筆規則を優先します。

## Article Principle

この skill が扱う本文の基本形は、技術記事ではなく技術エッセイです。

技術的な題材を扱いますが、手順や仕様を網羅することを主目的にしません。背景、違和感、観察、判断、試行錯誤を含めて、読み物として整理します。

Note 媒体に掲載する記事であっても、Note っぽい日記文、感想文、柔らかすぎる読み物調へ寄せません。Qiita 的な硬い手順記事、仕様中心の記事、網羅説明中心の記事にも寄せすぎません。

主に大事にするものは次の通りです。

- 技術的な題材を扱うこと
- みくくが考えながら整理している感じを残すこと
- 背景、違和感、気づき、判断、試行錯誤を書くこと
- 技術説明と観察を混ぜること
- 読者が考えながら追えるように、段落間のつなぎを置くこと
- 技術的に大事な結論は曖昧にしないこと

## Technical Essay Rules

- 本文は、みくく担当の技術エッセイとして扱う
- Note っぽい日記文、感想文、柔らかすぎる読み物文体へ寄せない
- Qiita 的な手順中心、仕様中心、網羅説明中心の記事へ寄せすぎない
- 技術説明が続いて硬くなる箇所には、必要に応じて短い補足文、観察文、つなぎ文を足す
- 補足文は、読者の理解、書き手の観察、判断の背景を助けるために使う
- 未確認の事実、実行していない体験、架空の成果を補足文として追加しない
- 大きな主張より、小さな観察や違和感から始める
- 断定しすぎず、個人の観測や仮説として自然に書く
- 生成AIを使った体験では、驚き、戸惑い、手応え、人間側の判断を残す
- 過剰にきれいな広告文や企業ブログ風にしない

## Paragraph And Markdown Rules

段落は、意味のある単位でまとめます。読み物・エッセイであっても、1文1段落のような細切れの改行を基本形にはしません。

- 1文ごとに空行を入れて段落を分けない
- 過度に短い段落を連続させない
- 同じ話題、同じ観察、同じ説明のまとまりは、1つの段落にまとめる
- 技術説明、観察、補足文をむやみに分断しない
- 余韻やエッセイ感を出すためだけの改行を多用しない
- 強調したい短文だけを独立段落にする場合は、記事全体で控えめに使う
- 通常の箇条書きは Markdown の `-` を使う
- 順序や手順そのものに意味がある場合だけ番号付きリストを使う

既存記事には、箇条書きにすべき短文が通常段落として残っている場合があります。これは文体サンプルとしては扱わず、必要な列挙は Markdown の `-` に整理します。

## Note Metadata Rules

Note 掲載用の属性情報が必要な場合、ローカル正本では front matter に集約する形を基本にします。

```markdown
---
title: 記事タイトル
tags: #tag1 #tag2 #tag3
author: igapyon
slide: false
published_to: note
writer_agent: みくく
url: ((TBD))
---
```

Note の `tags` は、実際の掲載用ハッシュタグに合わせて `#` 付きで書きます。Qiita の `tags` とは異なり、`#` を外さないでください。

既存記事には、次のような見出し形式の掲載情報が残っている場合があります。

```markdown
## 掲載先情報

- 掲載先: Note
- URL: （未記入）

From igapyon/igapyon-agent-skills, Apache-2.0.

More from igapyon/igapyon-agent-skills