igapyon-qiita-writer

Files (43)

• SKILL.md
• index.json
• 20260428-general.md · references/general/
• 20260429-general.md · references/general/
• 20260430-general-ai-dev-docs-workplace.md · references/general/
• 20260430-general-straight-conv.md · references/general/
• 20260430-general.md · references/general/
• 20260430-miku-soft-architecture-topic-bank.md · references/general/
• 20260502-general-repository-engineering.md · references/general/
• 20260503-general-miku-soft-agent-skills.md · references/general/
• 20260505-general-ai-agent-skills-basic.md · references/general/
• 20260515-general-miku-soft-repository-map.md · references/general/
• 20260412-miku-abc-player-intro.md · references/miku-abc-player/
• 20260509-miku-docx2md-usage.md · references/miku-docx2md/
• 20260506-miku-grep-usage.md · references/miku-grep/
• 20260428-miku-indexgen-intro.md · references/miku-indexgen/
• 20260509-miku-indexgen-usage.md · references/miku-indexgen/
• 20260506-miku-javaclass2json-usage.md · references/miku-javaclass2json/
• 20260506-miku-readfile-usage.md · references/miku-readfile/
• 20260506-miku-text-bundle-usage.md · references/miku-text-bundle/
• 20260320-vscode-gpt54-chat-dev.md · references/miku-xlsx2md/
• 20260320-xlsx2md-intro.md · references/miku-xlsx2md/
• 20260321-xlsx2md-cli-ai-dev-log.md · references/miku-xlsx2md/
• 20260321-xlsx2md-cli.md · references/miku-xlsx2md/
• 20260326-xlsx2md-grid-bugfix.md · references/miku-xlsx2md/
• 20260327-xlsx2md-rich-markdown.md · references/miku-xlsx2md/
• 20260425-xlsx2md-java.md · references/miku-xlsx2md/
• 20260509-miku-xlsx2md-usage.md · references/miku-xlsx2md/
• xlsx2md-feature-list-memo.md · references/miku-xlsx2md/
• 20260330-mikuproject-ai-wbs-draft.md · references/mikuproject/
• 20260330-mikuproject-intro.md · references/mikuproject/
• 20260407-mikuproject-ai-wbs-planning.md · references/mikuproject/
• 20260409-mikuproject-agent-skills-wbs-planning.md · references/mikuproject/
• 20260509-mikuproject-usage.md · references/mikuproject/
• 20260412-ai-score-abc-first.md · references/mikuscore/
• 20260509-mikuscore-usage.md · references/mikuscore/
• 2026XXXX-mikuscore-skills-intro.md · references/mikuscore/
• cli-maven-plugin-reference-pattern.md · templates/patterns/
• cli-reference-pattern.md · templates/patterns/
• design-thought-pattern.md · templates/patterns/
• development-log-pattern.md · templates/patterns/
• general-article-pattern.md · templates/patterns/
• tool-introduction-pattern.md · templates/patterns/

SKILL.md (first lines)

# igapyon-qiita-writer

Qiita 向けの日本語技術記事を作成・整理・改善するための skill です。

Qiita 記事への作業またはこの skill の使用が明示されていない一般的な文章校正、PR 文面、短文投稿、Note 向け記事、文章相談では、この skill を使わないでください。
Qiita 記事向けの skill があるか聞かれた場合は、この skill を候補として案内し、ユーザーが使用を依頼するまで適用しないでください。

この skill の目的は、文章を単にきれいにすることではありません。  
Qiita の読者が読みやすく、技術的な持ち帰りを得やすい形に整えることです。

Note 記事を書く場面でこの skill を直接の主担当にはしません。  
ただし、みくく担当の Note 記事で技術記事としての構成、説明粒度、CLI、仕様、手順、コマンド例の整理が足りない場合は、補助的な参考として使えます。

## Purpose

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

- Qiita 記事の新規作成
- 既存メモや README からの記事化
- 技術記事の見出し構成作成
- タイトル案とタグ案の作成
- Qiita front matter の作成・整形
- Note 風または日記風の文章を Qiita 向けに整理
- OSS、CLI、Web アプリ、Maven plugin、生成AI活用、開発ログの技術記事化
- 公開前原稿の読みやすさ、説明順、技術的粒度の調整

## When To Use

この skill の使用依頼、または Qiita 記事への明確な作業依頼で開始します。合意済みの Qiita 作業では、毎回スキル名や媒体名を繰り返す必要はありません。「タグを考えて」「front matter を付けて」「README から記事を書いて」だけでは、新たにこの skill を開始しません。

対象が明確な依頼の例:

- 「Qiita 記事にして」
- 「Qiita 用に整えて」
- 「Qiita 記事用のタグを考えて」
- 「Qiita 用の front matter を付けて」
- 「Qiita の技術記事として構成して」
- 「README から Qiita 記事を書いて」
- 「この開発ログを Qiita 向けにしたい」
- 「igapyon-qiita-writer を使って」

単なる短文 SNS 投稿、柔らかい Note 向け体験文、音楽寄りの随筆、PR 文面作成では、この skill を無理に使いません。

## Supplemental Use For Note Articles

Note 記事の正本、保存場所、Note 掲載用属性情報は `igapyon-note-writer` 側の規則に従います。
ユーザーがこの skill を Note 記事の補助参考として使うよう明示的に依頼した場合は、Qiita 向けの文体へ寄せすぎず、技術記事としての構成、説明順、用語の明確さ、制約の出し方だけを参考にします。Note の掲載情報だけの依頼は、この補助利用を開始しません。

## Qiita Article Shape

Qiita 記事では、次の情報が読み取りやすい順に並ぶようにします。

- 何を作ったか
- 何ができるか
- なぜ作ったか
- どう使うか
- 技術的な要点は何か
- どこを意図的に絞ったか
- 制約や未対応は何か
- 読者が試すときの入口はどこか

記事の基本構成は、必要に応じて次の形を使います。

1. はじめに
2. 何を作ったか
3. 使い方
4. 主な機能
5. 実装や設計のポイント
6. 制約・注意点
7. おわりに

すべての記事でこの構成を強制する必要はありません。  
題材に合わせて、読者が理解しやすい順序を優先します。

## Writing Rules

- 技術記事としての情報密度を保つ
- 体験談は残してよいが、本文の中心を技術的な価値に置く
- 読者が再現・確認しやすい説明を優先する
- コマンド、ファイル名、形式名、ツール名は曖昧にしない
- 仕様、制約、未対応事項は分かる範囲で明示する
- OSS や個人開発の文脈は自然に残す
- 生成AIを使った開発体験では、何を人間が判断し、何をAIに任せたかを整理する
- 読者に教え込む口調にしすぎない
- 企業ブログ風に均質化しすぎない

## Front Matter Rules

Qiita front matter が必要な場合は、次の形を基本にします。ローカル正本では、掲載先や公開 URL も front matter の独自キーとして一緒に管理します。

```markdown
---
title: 記事タイトル
tags: tag1 tag2 tag3
author: igapyon
slide: false
published_to: Qiita
writer_agent: みくく
url: https://qiita.com/igapyon/items/...
---
```

Qiita に貼り付ける本文を作る場合、Qiita 側で不要な独自キーは投稿前に除外してもかまいません。ただし、`references/` 配下のローカル Markdown では、公開先管理のために独自キーを残します。

既存原稿に front matter がある場合は、明示的な依頼なしに壊さないでください。

公開済み URL、公開記事タイトル、タグ、投稿日などが原稿内にある場合は、事実情報として尊重します。  
未確認の URL、公開状態、バージョン、実行結果は作らないでください。

## Reference Usage

`references/` 配下の記事は、Qiita 技術記事の正本であり、Qiita 記事の実例集としても使います。

Qiita 記事を新規作成・更新する場合は、`skills/igapyon-qiita-writer/references/` 配下の Markdown を正本として扱います。  
`workplace/*/docs/articles/qiita/` などに旧配置や作業メモがある場合でも、公開・更新対象の本文はこの skill 配下の `references/` に置きます。

主に見る観点は次の通りです。

- タイトルの付け方

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

More from igapyon/igapyon-agent-skills