@nahisaho/shikigami 1.1.0

package/.github/skills/shikigami-writing/SKILL.md

@@ -0,0 +1,782 @@
+---
+name: shikigami-writing
+description: |
+  レポート生成・品質保証スキル。Deep Researchの結果を高品質なレポートに変換。
+  Qiita記事テンプレート対応、ハルシネーション検出、不確実性マーキング、引用管理を実現。
+license: MIT
+---
+
+# SHIKIGAMI Writing Agent Skill
+
+**目的**: リサーチ結果を高品質なレポートに変換し、品質を保証する。
+
+## スキル概要
+
+Deep Researchの結果を構造化されたレポートに変換します。
+
+### 特徴
+
+- **複数フォーマット**: Markdown、Qiita記事、PDF向け
+- **品質保証**: ハルシネーション検出、不確実性マーキング
+- **引用管理**: 自動引用生成、参考文献リスト
+- **図表生成**: Mermaidダイアグラム自動生成
+
+---
+
+## Phase 1: レポート構成設計
+
+### レポートタイプ選択
+
+```markdown
+## 📝 レポートタイプ選択
+
+**入力データ**: [Evolving Reportまたは分析結果]
+**対象読者**: [誰が読むか]
+**目的**: [何を伝えたいか]
+
+### 推奨フォーマット
+
+| タイプ | 適合度 | 理由 |
+|--------|--------|------|
+| **調査レポート** | ⭐⭐⭐ | [理由] |
+| **技術記事（Qiita）** | ⭐⭐ | [理由] |
+| **提案書** | ⭐ | [理由] |
+| **議事録/サマリー** | ⭐ | [理由] |
+
+### 選択: [タイプ]
+```
+
+### 構成テンプレート
+
+```markdown
+## 📋 レポート構成案
+
+### 調査レポート構成
+
+1. **エグゼクティブサマリー** (1ページ)
+   - 背景・目的
+   - 主要発見事項（3点）
+   - 結論・推奨事項
+
+2. **背景・目的** (1-2ページ)
+   - 調査の背景
+   - 調査目的
+   - 調査範囲・方法
+
+3. **調査結果** (5-10ページ)
+   - トピック1
+   - トピック2
+   - トピック3
+
+4. **分析・考察** (2-3ページ)
+   - データの解釈
+   - 示唆
+   - 限界・留意点
+
+5. **結論・提言** (1-2ページ)
+   - 結論
+   - 推奨アクション
+   - 次のステップ
+
+6. **付録**
+   - 参考文献
+   - 用語集
+   - 詳細データ
+```
+
+---
+
+## Phase 2: レポート生成
+
+### 調査レポートテンプレート
+
+````markdown
+## 📄 調査レポート
+
+# [レポートタイトル]
+
+**作成日**: [YYYY-MM-DD]
+**作成者**: [名前/組織]
+**バージョン**: [v1.0]
+**機密区分**: [公開/社外秘/極秘]
+
+---
+
+## エグゼクティブサマリー
+
+### 背景
+[1-2文で背景を説明]
+
+### 調査目的
+[調査の目的を明記]
+
+### 主要発見事項
+1. **[発見1]**: [概要]
+2. **[発見2]**: [概要]
+3. **[発見3]**: [概要]
+
+### 結論
+[主要な結論を1-2文で]
+
+### 推奨アクション
+- [アクション1]
+- [アクション2]
+- [アクション3]
+
+---
+
+## 1. 背景・目的
+
+### 1.1 調査の背景
+[なぜこの調査が必要になったか]
+
+### 1.2 調査目的
+[何を明らかにするか]
+
+### 1.3 調査範囲
+| 項目 | 範囲 |
+|------|------|
+| 対象期間 | [期間] |
+| 対象地域 | [地域] |
+| 対象業界 | [業界] |
+| 除外事項 | [対象外とした事項] |
+
+### 1.4 調査方法
+[どのように調査したか]
+
+---
+
+## 2. 調査結果
+
+### 2.1 [トピック1]
+
+#### 概要
+[トピックの概要]
+
+#### 詳細
+
+[詳細な説明]
+
+**根拠データ**:
+| 指標 | 数値 | 出典 |
+|------|------|------|
+| [指標1] | [値] | [[1]](#ref-1) |
+| [指標2] | [値] | [[2]](#ref-2) |
+
+> ⚠️ **不確実性注記**: この数値は単一ソースからの推定値です。
+
+#### 図表
+
+```mermaid
+graph LR
+    A[要因1] --> B[結果]
+    C[要因2] --> B
+    D[要因3] --> B
+```
+
+### 2.2 [トピック2]
+[同様の構造で記述]
+
+### 2.3 [トピック3]
+[同様の構造で記述]
+
+---
+
+## 3. 分析・考察
+
+### 3.1 発見事項の解釈
+[データから何が言えるか]
+
+### 3.2 示唆
+[ビジネスへの影響・意味]
+
+### 3.3 限界・留意点
+- [限界1]: [説明]
+- [限界2]: [説明]
+- [留意点]: [説明]
+
+---
+
+## 4. 結論・提言
+
+### 4.1 結論
+[調査の結論]
+
+### 4.2 推奨アクション
+
+| 優先度 | アクション | 期限 | 担当 |
+|--------|-----------|------|------|
+| 高 | [アクション1] | [期限] | [担当] |
+| 中 | [アクション2] | [期限] | [担当] |
+| 低 | [アクション3] | [期限] | [担当] |
+
+### 4.3 次のステップ
+1. [ステップ1]
+2. [ステップ2]
+3. [ステップ3]
+
+---
+
+## 参考文献
+
+<a id="ref-1">[1]</a> [著者]. "[タイトル]". [出版社/サイト], [日付]. [URL]
+
+<a id="ref-2">[2]</a> [著者]. "[タイトル]". [出版社/サイト], [日付]. [URL]
+
+<a id="ref-3">[3]</a> [著者]. "[タイトル]". [出版社/サイト], [日付]. [URL]
+
+---
+
+## 用語集
+
+| 用語 | 定義 |
+|------|------|
+| [用語1] | [定義] |
+| [用語2] | [定義] |
+````
+
+---
+
+### Qiita記事テンプレート
+
+#### REQ-WR-006〜012 準拠: Qiita Markdown完全対応
+
+````markdown
+## 📄 Qiita記事
+
+# [タイトル] <!-- 50文字以内推奨、検索キーワードを含める -->
+
+<!-- タグ候補（最大5つ）: #[タグ1] #[タグ2] #[タグ3] #[タグ4] #[タグ5] -->
+
+## はじめに
+
+[読者の課題・悩みに共感する導入]
+
+**この記事で分かること**:
+- [ポイント1]
+- [ポイント2]
+- [ポイント3]
+
+**想定読者**:
+- [読者層1]
+- [読者層2]
+
+:::note info
+**所要時間**: 約X分
+**難易度**: 初級/中級/上級
+:::
+
+---
+
+## [セクション1]: [タイトル]
+
+### [サブセクション1.1]
+
+[説明文 - 1段落3〜5行以内]
+
+```[言語]:sample.ts
+// ファイル名付きコードブロック
+const example = "Hello, Qiita!";
+console.log(example);
+```
+
+:::note warn
+**注意**: [重要な注意点]
+:::
+
+### [サブセクション1.2]
+
+[説明文]
+
+<details>
+<summary>詳細な説明（クリックで展開）</summary>
+
+[長い内容や補足情報]
+
+</details>
+
+---
+
+## [セクション2]: [タイトル]
+
+[内容]
+
+### 図解
+
+```mermaid
+[ダイアグラム]
+```
+
+### 数式（必要な場合）
+
+インライン数式: $E = mc^2$
+
+ブロック数式:
+
+$$
+\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
+$$
+
+---
+
+## [セクション3]: 実践・応用
+
+### ユースケース1: [タイトル]
+
+```[言語]:usecase1.ts
+[実践的なコード例]
+```
+
+:::note alert
+**警告**: [危険な操作や注意すべき点]
+:::
+
+### ユースケース2: [タイトル]
+
+[実践的な例]
+
+---
+
+## まとめ
+
+| ポイント | 内容 |
+|----------|------|
+| [ポイント1] | [まとめ] |
+| [ポイント2] | [まとめ] |
+| [ポイント3] | [まとめ] |
+
+### 次のステップ
+- [次に学ぶべきこと]
+- [関連トピック]
+
+---
+
+## 参考資料
+
+<!-- リンクカード形式（URLを単独行に記載） -->
+https://example.com/reference1
+
+- [リソース2](URL)
+- [リソース3](URL)
+
+---
+
+**いいね :+1: と ストック :star: をお願いします！**
+````
+
+---
+
+### Qiita固有記法リファレンス（REQ-WR-008）
+
+| 記法 | 用途 | 例 |
+|------|------|-----|
+| **コードブロック** | コードの表示 | ` ```python:sample.py ` （ファイル名付き） |
+| **数式** | 数式の表示 | `$E = mc^2$`（インライン）、`$$...$$`（ブロック） |
+| **Info注釈** | 補足情報 | `:::note info` |
+| **警告注釈** | 注意喚起 | `:::note warn` |
+| **危険注釈** | 重大な警告 | `:::note alert` |
+| **折りたたみ** | 長い内容の格納 | `<details><summary>タイトル</summary>` |
+| **リンクカード** | 外部リンク | URLを単独行に記載 |
+| **絵文字** | 感情表現 | `:smile:` `:+1:` `:star:` |
+
+---
+
+### Qiita記事タイプ別テンプレート（REQ-WR-012）
+
+#### 技術解説記事
+
+```markdown
+# [技術名]入門：[サブタイトル]
+
+## はじめに
+[技術の概要と学ぶメリット]
+
+## [技術名]とは
+### 概要
+### 特徴
+### ユースケース
+
+## 基本的な使い方
+### インストール
+### Hello World
+### 基本構文
+
+## 応用例
+[実践的な例]
+
+## ベストプラクティス
+[推奨される使い方]
+
+## まとめ
+## 参考資料
+```
+
+#### チュートリアル記事
+
+```markdown
+# [成果物]を作ってみよう：[技術名]チュートリアル
+
+## はじめに
+**完成イメージ**: [スクリーンショット/デモ]
+**所要時間**: 約X分
+
+## 事前準備
+- [ ] [必要なもの1]
+- [ ] [必要なもの2]
+
+## Step 1: [ステップタイトル]
+[手順]
+
+## Step 2: [ステップタイトル]
+[手順]
+
+## Step 3: [ステップタイトル]
+[手順]
+
+## 動作確認
+[確認方法]
+
+## トラブルシューティング
+| 問題 | 解決策 |
+|------|--------|
+
+## まとめ
+## 次のステップ
+```
+
+#### Tips/備忘録記事
+
+```markdown
+# [技術名] Tips: [具体的なトピック]
+
+## TL;DR
+[3行で要約]
+
+## 背景・課題
+[なぜこのTipsが必要か]
+
+## 解決策
+```[言語]
+[コード]
+```
+
+## 解説
+[なぜこれで解決するか]
+
+## 参考
+```
+
+#### 比較分析記事
+
+```markdown
+# [技術A] vs [技術B]: [観点]で徹底比較
+
+## はじめに
+[比較の目的]
+
+## 比較表
+| 項目 | [技術A] | [技術B] |
+|------|---------|---------|
+| [項目1] | | |
+| [項目2] | | |
+
+## 詳細比較
+### [観点1]
+### [観点2]
+### [観点3]
+
+## 選定ガイド
+- **[技術A]を選ぶべき場合**: [条件]
+- **[技術B]を選ぶべき場合**: [条件]
+
+## まとめ
+```
+
+#### トラブルシューティング記事
+
+```markdown
+# [エラーメッセージ/問題]の解決方法
+
+## 症状
+```
+[エラーメッセージ]
+```
+
+## 環境
+- OS: 
+- バージョン:
+
+## 原因
+[なぜ発生するか]
+
+## 解決策
+
+### 方法1: [タイトル]
+[手順]
+
+### 方法2: [タイトル]（方法1で解決しない場合）
+[手順]
+
+## 予防策
+[再発防止]
+
+## 参考
+```
+
+#### Deep Research調査レポート記事
+
+```markdown
+# [調査テーマ]: Deep Research調査レポート
+
+## エグゼクティブサマリー
+[3-5行で結論]
+
+## 調査概要
+| 項目 | 内容 |
+|------|------|
+| 調査期間 | |
+| 情報源数 | |
+| 主要キーワード | |
+
+## 調査結果
+
+### 1. [発見事項1]
+[詳細]
+
+:::note info
+**信頼度**: ⭐⭐⭐⭐☆
+**ソース数**: X件
+:::
+
+### 2. [発見事項2]
+[詳細]
+
+### 3. [発見事項3]
+[詳細]
+
+## 分析・考察
+[データの解釈]
+
+## 結論
+[まとめ]
+
+## 参考資料
+[情報源リスト]
+```
+
+---
+
+### Qiita SEO最適化ガイドライン（REQ-WR-009）
+
+```markdown
+## SEOチェックリスト
+
+### タイトル最適化
+- [ ] 主要キーワードを含む（最初の方に配置）
+- [ ] 50文字以内で簡潔
+- [ ] 読者のベネフィットを示唆
+- [ ] 数字や具体性を含む（「5選」「入門」「完全ガイド」等）
+
+### 見出し最適化
+- [ ] H2にはキーワードを含める
+- [ ] 階層構造が論理的（H2→H3→H4）
+- [ ] 見出しだけで記事構成が分かる
+
+### 本文最適化
+- [ ] 冒頭200文字に結論を含める
+- [ ] 1段落3〜5行以内
+- [ ] 箇条書き・表で読みやすく
+- [ ] 内部リンク（自分の関連記事）を含める
+
+### タグ最適化
+推奨タグ候補（記事内容から自動提案）:
+1. [メイン技術タグ]
+2. [関連技術タグ]
+3. [カテゴリタグ]
+4. [レベルタグ]（初心者向け等）
+5. [トレンドタグ]
+```
+
+---
+
+## Phase 3: 品質保証
+
+### ハルシネーション検出
+
+```markdown
+## 🔍 ハルシネーション検出
+
+### 検出ルール
+1. **ソースなし主張**: 出典が示されていない事実主張
+2. **古いデータ**: 3年以上前のデータを現在形で使用
+3. **過度の一般化**: サンプルサイズが不十分な一般化
+4. **因果関係の誤認**: 相関を因果と混同
+5. **数値の不整合**: 合計が合わない、パーセントが100%超
+
+### 検出結果
+
+| # | 箇所 | 問題 | 重大度 | 対処 |
+|---|------|------|--------|------|
+| 1 | [ページ/セクション] | [問題の説明] | [高/中/低] | [修正方法] |
+| 2 | [箇所] | [問題] | [重大度] | [対処] |
+
+### 修正アクション
+- [ ] [修正1]
+- [ ] [修正2]
+- [ ] [修正3]
+```
+
+### 不確実性マーキング
+
+レポート内で不確実な情報を明示的にマーク：
+
+```markdown
+### マーキング凡例
+
+| マーク | 意味 | 使用場面 |
+|--------|------|----------|
+| ⚠️ **不確実** | 単一ソース、要追加検証 | 1つのソースのみの情報 |
+| ❓ **推定** | 直接的なデータなし | 間接的な推論に基づく |
+| 📊 **統計的** | 統計的推定値 | 誤差範囲あり |
+| 🕐 **時限的** | 情報の鮮度に注意 | 古いデータ |
+| 💭 **意見** | 事実ではなく意見 | 専門家の見解 |
+
+### 使用例
+
+> ⚠️ **不確実性注記**: 以下の数値は業界レポート[[1]](#ref-1)からの
+> 引用であり、調査方法の詳細は不明です。
+
+> ❓ **推定**: 直接的なデータがないため、類似事例から推定しています。
+
+> 🕐 **注意**: このデータは2023年時点のものです。最新状況は異なる可能性があります。
+```
+
+### 引用チェック
+
+```markdown
+## 📚 引用品質チェック
+
+### 引用統計
+| 指標 | 値 | 基準 | 状態 |
+|------|-----|------|------|
+| 総引用数 | [N] | 10+ | ✅/⚠️/❌ |
+| ユニークソース | [M] | 5+ | ✅/⚠️/❌ |
+| 高信頼ソース率 | [X]% | 60%+ | ✅/⚠️/❌ |
+| 1年以内のソース | [Y]% | 50%+ | ✅/⚠️/❌ |
+
+### ソース品質分布
+| カテゴリ | 件数 | 割合 |
+|----------|------|------|
+| 学術論文 | [N] | [X]% |
+| 政府統計 | [N] | [X]% |
+| 業界レポート | [N] | [X]% |
+| ニュース記事 | [N] | [X]% |
+| 企業発表 | [N] | [X]% |
+| その他 | [N] | [X]% |
+
+### 引用漏れチェック
+- [ ] すべての数値に出典があるか
+- [ ] すべての事実主張に根拠があるか
+- [ ] 引用番号が連続しているか
+- [ ] リンク切れがないか
+```
+
+---
+
+## Phase 4: 最終品質スコア
+
+```markdown
+## ✅ レポート品質スコア
+
+**レポート**: [タイトル]
+**評価日**: [YYYY-MM-DD]
+
+### スコア詳細
+
+| カテゴリ | スコア | 重み | 加重スコア |
+|----------|--------|------|------------|
+| **構造** | [X]/10 | 20% | [Y] |
+| **正確性** | [X]/10 | 30% | [Y] |
+| **引用品質** | [X]/10 | 20% | [Y] |
+| **可読性** | [X]/10 | 15% | [Y] |
+| **完全性** | [X]/10 | 15% | [Y] |
+| **総合** | - | - | **[合計]/10** |
+
+### 評価基準
+
+| スコア | 評価 | 説明 |
+|--------|------|------|
+| 9-10 | 優秀 | 出版レベル |
+| 7-8 | 良好 | 軽微な修正で完成 |
+| 5-6 | 可 | いくつかの改善が必要 |
+| 3-4 | 要改善 | 大幅な修正が必要 |
+| 1-2 | 不可 | 再作成が必要 |
+
+### 改善提案
+1. [改善点1]: [具体的な提案]
+2. [改善点2]: [具体的な提案]
+3. [改善点3]: [具体的な提案]
+
+### 承認状態
+- [ ] 自己レビュー完了
+- [ ] 品質基準クリア（7以上）
+- [ ] ハルシネーションなし
+- [ ] 発行準備完了
+```
+
+---
+
+## Mermaid ダイアグラム生成
+
+### 自動生成可能なダイアグラム
+
+```markdown
+### フローチャート
+```mermaid
+graph TD
+    A[開始] --> B{判断}
+    B -->|Yes| C[処理1]
+    B -->|No| D[処理2]
+    C --> E[終了]
+    D --> E
+```
+
+### シーケンス図
+```mermaid
+sequenceDiagram
+    participant U as ユーザー
+    participant S as システム
+    participant D as データベース
+    U->>S: リクエスト
+    S->>D: クエリ
+    D-->>S: 結果
+    S-->>U: レスポンス
+```
+
+### タイムライン
+```mermaid
+timeline
+    title プロジェクトタイムライン
+    2024 Q1 : 企画
+    2024 Q2 : 開発
+    2024 Q3 : テスト
+    2024 Q4 : リリース
+```
+
+### 円グラフ
+```mermaid
+pie title 市場シェア
+    "A社" : 40
+    "B社" : 30
+    "C社" : 20
+    "その他" : 10
+```
+```
+
+---
+
+## 関連スキル
+
+- **shikigami-planner**: レポートの目的・読者の明確化
+- **shikigami-deep-research**: レポートの素材となる調査実行
+- **shikigami-consulting-framework**: 分析セクションのフレームワーク適用