Shikigami Writing

SHIKIGAMI Writing

バージョニングルール（必須）

⚠️ 既存ファイルの上書き禁止

[レポート名]-v[メジャー].[マイナー].md

Phase 1: レポート構成設計

Phase 2: レポート生成

調査レポート構成

1. エグゼクティブサマリー（1ページ）
2. 背景・目的
3. 調査結果（トピック別）
4. 分析・考察
5. 結論・提言
6. 📐 思考フロー・トレース（v1.20.0）🆕
7. 参考文献（URL必須）

引用ルール（必須）

• すべての事実・数値にソースURL付与
• インライン: [[1]](#ref-1)
• 参考文献: <a id="ref-1">[1]</a> [タイトル](URL) - 日付

不確実性マーキング

Phase 3: 品質保証

自動品質チェック（v1.16.0）

レポート生成完了時に自動呼び出し:

• @consistency-check: 数値・用語の一貫性
• @executive-sync: 要約と本文の整合

品質スコア

基準: 7/10以上で承認

Qiita Writing Rules（v1.21.0）🆕

フロントマター（必須）

---
title: "[タイトル]"           # 必須: 50文字以内推奨
tags: Tag1, Tag2, Tag3        # 必須: 1〜5個（カンマ区切り）
private: false                # 必須: 公開=false, 限定公開=true
updated_at: '2026-01-26'      # 自動: 更新日時
id: null                      # 自動: 投稿後に付与
organization_url_name: null   # 任意: Organization投稿時
slide: false                  # 任意: スライドモード
---

タグ選定ルール

禁止事項:

• 同義タグの重複（JavaScriptとJS両方）
• 関連性の薄いタグ
• 5個を超えるタグ

タイトル最適化

良い例:

• ✅ 【2026年版】GitHub Copilot完全ガイド｜実務で使える10のTips
• ✅ Python初心者が3日でWebアプリを作る方法【Flask入門】

悪い例:

• ❌ Pythonについて（抽象的すぎる）
• ❌ 私がReactを学んで感じた様々なことについての考察と今後の展望（長すぎる）

記事構成ガイドライン

推奨総文字数: 2,000〜5,000文字（読了時間5-15分）

Qiita記法リファレンス

注釈ボックス

:::note info
💡 **ポイント**: 補足情報・Tips
:::

:::note warn
⚠️ **注意**: 警告・落とし穴
:::

:::note alert
🚨 **重要**: 致命的な注意点
:::

コードブロック

```python:main.py
# ファイル名を表示
def hello():
    print("Hello, Qiita!")

- old_code()
+ new_code()

#### 折りたたみ

```markdown
<details><summary>クリックで展開</summary>

長いコードや補足情報

</details>

数式（KaTeX）

インライン: $E = mc^2$

ブロック:
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

リンクカード

https://qiita.com/example/items/xxxxx
（URLを単独行に書くとカード表示）

品質チェックリスト

SEO最適化

Qiita記事テンプレート

---
title: "[タイトル]（50文字以内）"
tags: Tag1, Tag2, Tag3
private: false
updated_at: ''
id: null
organization_url_name: null
slide: false
---

# はじめに

**この記事で分かること**:
- ポイント1
- ポイント2
- ポイント3

**想定読者**: [読者層]

:::note info
📖 **所要時間**: 約X分
🎯 **難易度**: 初級/中級/上級
💻 **環境**: Node.js 20+, TypeScript 5.x
:::

## 前提条件

- 前提知識1
- 前提知識2

## セクション1

[内容]

```typescript:example.ts
// ファイル名付きコードブロック
const greeting = "Hello, Qiita!";
console.log(greeting);

:::note warn 注意: [重要な注意点] :::

セクション2

[内容]

長い内容や補足情報

まとめ

次のステップ: [次に学ぶべきこと、関連記事へのリンク]

参考資料

• 参考資料1 - 説明
• 参考資料2 - 説明
• 公式ドキュメント

---

## 成功条件タイプ別構成（v1.6.0）

| タイプ | 構成 |
|--------|------|
| IMMEDIATE_APPROVAL | 結論先行、詳細は付録 |
| STAGED_APPROVAL | 各決裁者向けサマリー |
| BUDGET_APPROVAL | 財務計画・ROI冒頭 |
| PILOT_APPROVAL | PoC計画・Go/No-Go基準 |

---

## 拡張機能

### セールスプレイブック（v1.9.0）
成功条件: INTERNAL_ENABLEMENT時に生成

### トークスクリプト（v1.9.0）
ACEフレームワーク: Acknowledge→Counter→Evidence

### 優先度スコアリング（v1.9.0）
4軸評価: 緊急度30%/機会規模30%/アクセス20%/戦略適合20%

### 競合比較表（v1.10.0）
自動抽出→ハイライト付き比較表生成

### 財務分析自動統合（v1.16.0）
BUDGET_APPROVAL時に `@financial-analysis` 自動呼び出し

### KPIダッシュボード（v1.16.0）
レポート内KPIから追跡用ダッシュボード定義を自動生成

### ASCII→Mermaid変換（v1.11.0）
ASCII図を自動検出してMermaidに変換

### 参考文献自動整形（v1.11.0）
ソース種別判定→統一フォーマット

### 思考フロー可視化（v1.20.0）🆕
レポート作成に至るまでの思考プロセスを自動追跡・可視化

**含まれる内容**:
- 🗺️ フローマップ（Mermaidダイアグラム）
- 📜 思考ログ（時系列の判断記録）
- 🔀 重要な判断ポイント（仮説修正・方針転換）
- 📈 思考メトリクス（調査ラウンド数、検証率等）

**自動記録されるステップ**:
| Phase | ステップ |
|-------|---------|
| 0: 初期化 | プロジェクト作成、ナレッジ継承 |
| 1: 目的探索 | 目的発見、仮説生成、計画立案 |
| 2: Deep Research | Think/Search/Visit/Verify/Report更新 |
| 3: 分析 | フレームワーク選択・適用、洞察抽出 |
| 4: レポート | 構成設計、生成、品質検証、引用整形 |

**設定**: `configs/thinking-flow.yaml`

---

## 32テンプレート（v1.9.0）

| カテゴリ | テンプレート例 |
|---------|---------------|
| 承認・稟議 | immediate-approval, budget-approval, pilot-approval |
| ビジネス分析 | executive-summary, competitive-analysis, market-analysis |
| 調達 | rfp, rfi, vendor-evaluation, sla |
| 技術 | technical-report, security-assessment |
| その他 | white-paper, training-material, post-mortem |

---

## 保存先
`projects/pjXXXXX_Name_YYYYMMDD/reports/[レポート名]-v[X.Y].md`

## 関連スキル
- **shikigami-planner**: 目的・読者の明確化
- **shikigami-deep-research**: 素材となる調査
- **shikigami-consulting-framework**: フレームワーク分析