name: product-writer
description: "AI Solo Craft のプロダクト辞書ページを作成・更新するスキル。DB直接投入方式。"
Product Writer Skill
AI Solo Craft のプロダクト辞書ページを作成・更新するスキル。
最重要ルール: DB直接投入(mdファイル禁止)
すべてのコンテンツはDBに直接投入する。mdファイル(content/)は作成しない。
DB投入には scripts/db-insert.sh を使用する:
./scripts/db-insert.sh /tmp/product.json
使用タイミング
- 新規プロダクトページの作成
- 既存プロダクトページの品質改善
- 「プロダクト記事作成」「製品ページ追加」「product更新」などの作業
リファレンス
- ベンチマークサイト:
references/BENCHMARKS.md
- 品質基準(4段階Tier):
references/quality-tiers.md
- DB投入用JSONテンプレート:
references/example-product.json
- body_markdown テンプレート:
references/template-body.md
- タグリスト(18カテゴリ):
references/tags.md
- DB投入スクリプト:
scripts/db-insert.sh
品質基準(概要)
詳細は references/quality-tiers.md を参照。
| ランク | Tier達成 |
|---|
| 最高品質 | Tier 1-4すべて |
| 高品質 | Tier 1-3 |
| 中品質 | Tier 1-2 |
| 低品質 | Tier 1のみ |
- Tier 1(必須): 基本情報テーブル、概要説明、主要機能3+、料金プラン、公式リンク
- Tier 2(標準): 個人開発者向け活用、注意点・制限、競合比較
- Tier 3(高品質): ユーザーの声、Pros/Cons、FAQ、関連ニュース
- Tier 4(最高): Getting Started、ターゲットユーザー、総合スコア、ワークフロー図解、コミュニティ、API
ワークフロー
新規作成
references/example-product.json をベースにJSONを作成
- 公式サイト・ドキュメントを調査
- Reddit/HN でユーザーの声を収集(3-5件)
- Pros/Cons を整理(10+/5+)
- FAQを5-10問作成
references/template-body.md に従って全項目を埋める
- DB投入:
./scripts/db-insert.sh /tmp/product.json
npm run publish:gate 実行
既存更新
- DBから現在のコンテンツを取得
- 改善が必要な項目を特定
- 更新後のJSONを作成
- DB投入(slugが同じなら上書き)
npm run publish:gate 実行
禁止事項
- mdファイルを作成する(content/ディレクトリへの書き込み禁止)
- Tier 1未満の品質で公開する
- 公式リンクなしで公開する
よくある落とし穴
- mdファイルを作成してしまう: content/ ディレクトリにmdファイルを作成するのは禁止。すべてのコンテンツは
create-content-db.mjs --stdin でDB直接投入する。mdファイルを作ると二重管理になり不整合が起きる
- DB投入後に publish:gate を忘れる: JSONを投入しただけでは公開されない。必ず
npm run publish:gate まで実行して初めて完了
- answerとoptionsの表記不一致(テンプレート内): body_markdown 内のテーブルや比較表で、同じプロダクト名を異なる表記で書いてしまうことがある。表記は一貫させる