@nahisaho/shikigami 1.20.0 → 1.22.0

package/.github/prompts/shikigami-qiita-article.prompt.md

@@ -0,0 +1,225 @@
+---
+mode: agent
+description: Qiita記事を作成する（Qiita Writing Rules強制適用）
+tools: ['shikigami-writing']
+---
+
+# Qiita記事作成プロンプト（v1.22.0）
+
+> **⚠️ 重要**: このプロンプトが呼び出されたら、**必ず**Qiita Writing Rulesを適用すること。
+> 
+> **WHEN**: 「Qiita記事」「技術記事」「Qiitaに投稿」等のキーワードを検出
+> **DO**: Qiita専用フォーマットで記事を生成
+
+---
+
+## 🎯 トリガーキーワード
+
+以下のキーワードを検出したら、このプロンプトを適用：
+
+| キーワード（日本語） | キーワード（英語） |
+|---------------------|-------------------|
+| Qiita記事 | Qiita article |
+| 技術記事 | tech article |
+| Qiitaに投稿 | post to Qiita |
+| Qiita用 | for Qiita |
+| Qiita向け | Qiita-style |
+| 技術ブログ | tech blog |
+
+---
+
+## 📋 必須適用ルール
+
+### 1. フロントマター（必須）
+
+```yaml
+---
+title: "[タイトル]"           # 必須: 50文字以内
+tags: Tag1, Tag2, Tag3        # 必須: 1〜5個（カンマ区切り）
+private: false                # 必須: 公開=false, 限定公開=true
+updated_at: ''                # 自動: 投稿時に設定
+id: null                      # 自動: 投稿後に付与
+organization_url_name: null   # 任意: Organization投稿時
+slide: false                  # 任意: スライドモード
+---
+```
+
+### 2. タイトルルール
+
+| ルール | 基準 |
+|--------|------|
+| **文字数** | 30〜50文字（50文字超は検索で切れる） |
+| **キーワード** | 主要キーワードを**前半に配置** |
+| **数字** | 具体的数字で訴求（「5つの方法」「3ステップ」） |
+| **ターゲット** | 対象読者を明示（「初心者向け」「実務で使える」） |
+
+**✅ 良い例**:
+- `【2026年版】GitHub Copilot完全ガイド｜実務で使える10のTips`
+- `Python初心者が3日でWebアプリを作る方法【Flask入門】`
+
+**❌ 悪い例**:
+- `Pythonについて`（抽象的すぎる）
+- `私がReactを学んで感じた様々なことについての考察`（長すぎる）
+
+### 3. タグ選定ルール
+
+| タイプ | 説明 | 例 |
+|--------|------|-----|
+| **メインタグ** | 記事の主題（1個） | `Python`, `React`, `AWS` |
+| **技術タグ** | 使用技術（1-2個） | `TypeScript`, `Docker` |
+| **カテゴリタグ** | 記事種別（1個） | `初心者向け`, `Tips` |
+| **トレンドタグ** | 旬のタグ（0-1個） | `ChatGPT`, `Copilot` |
+
+**禁止**: 5個超、同義タグ重複（`JavaScript`と`JS`）
+
+### 4. 記事構成（必須セクション）
+
+```markdown
+# はじめに（200-400字）
+- この記事で分かること（箇条書き）
+- 想定読者
+- 所要時間・難易度・環境（:::note info）
+
+## 前提条件（100-200字）※任意
+
+## 本文セクション（1500-4000字）
+- H2/H3で構造化
+- コードブロックにはファイル名付与
+- 注意点は :::note warn/alert
+
+## まとめ（200-300字）
+- 要点を表形式で整理
+- 次のステップ
+
+## 参考資料
+- URL付きリンク必須
+```
+
+**推奨総文字数**: 2,000〜5,000文字（読了時間5-15分）
+
+### 5. Qiita専用記法
+
+#### 注釈ボックス
+```markdown
+:::note info
+💡 **ポイント**: 補足情報
+:::
+
+:::note warn
+⚠️ **注意**: 落とし穴
+:::
+
+:::note alert
+🚨 **重要**: 致命的な注意点
+:::
+```
+
+#### ファイル名付きコードブロック
+```markdown
+```python:main.py
+def hello():
+    print("Hello, Qiita!")
+```
+```
+
+#### 折りたたみ
+```markdown
+<details><summary>📝 詳細（クリックで展開）</summary>
+
+長い内容
+
+</details>
+```
+
+---
+
+## ✅ 生成前チェックリスト
+
+```
+☐ フロントマター完備（title, tags, private）
+☐ タイトル50文字以内、キーワード前半配置
+☐ タグ1〜5個、適切な選定
+☐ 「はじめに」に対象読者・得られる知識を明記
+☐ コードブロックにファイル名付与（```python:main.py）
+☐ 注釈ボックス（:::note）を活用
+☐ 参考資料にURL付き
+☐ 総文字数2,000〜5,000文字
+```
+
+---
+
+## 📝 テンプレート
+
+```markdown
+---
+title: "[タイトル]（50文字以内）"
+tags: Tag1, Tag2, Tag3
+private: false
+updated_at: ''
+id: null
+organization_url_name: null
+slide: false
+---
+
+# はじめに
+
+**この記事で分かること**:
+- ポイント1
+- ポイント2
+- ポイント3
+
+**想定読者**: [読者層]
+
+:::note info
+📖 **所要時間**: 約X分
+🎯 **難易度**: 初級/中級/上級
+💻 **環境**: [環境情報]
+:::
+
+## 前提条件
+
+- 前提知識1
+- 前提知識2
+
+## セクション1
+
+[内容]
+
+```typescript:example.ts
+const greeting = "Hello, Qiita!";
+console.log(greeting);
+```
+
+:::note warn
+**注意**: [重要な注意点]
+:::
+
+## セクション2
+
+[内容]
+
+<details><summary>📝 詳細な説明（クリックで展開）</summary>
+
+長い内容や補足情報
+
+</details>
+
+## まとめ
+
+| ポイント | 内容 |
+|---------|------|
+| 1 | 要点1 |
+| 2 | 要点2 |
+| 3 | 要点3 |
+
+**次のステップ**: [次に学ぶべきこと]
+
+## 参考資料
+
+- [参考資料1](https://example.com) - 説明
+- [公式ドキュメント](https://example.com)
+```
+
+---
+
+**詳細ルール参照**: [shikigami-writing SKILL.md](../skills/shikigami-writing/SKILL.md#qiita-writing-rules)

package/.github/prompts/shikigami-report-writing.prompt.md

@@ -11,12 +11,42 @@ tools: ['shikigami-writing']
 
 ## 🎯 レポートタイプ選択
 
-| タイプ | 対象読者 | 特徴 |
-|--------|----------|------|
-| **調査レポート** | 経営層・意思決定者 | 詳細な調査結果報告 |
-| **技術記事** | 技術者・エンジニア | Qiita形式の知見共有 |
-| **提案書** | クライアント・承認者 | ROI・アクション重視 |
-| **サマリー** | 全関係者 | 1ページ要約 |
+| タイプ | 対象読者 | 特徴 | 参照ルール |
+|--------|----------|------|-----------|
+| **調査レポート** | 経営層・意思決定者 | 詳細な調査結果報告 | 標準Writing Rules |
+| **技術記事（Qiita）** | 技術者・エンジニア | Qiita形式の知見共有 | **Qiita Writing Rules** |
+| **提案書** | クライアント・承認者 | ROI・アクション重視 | 標準Writing Rules |
+| **サマリー** | 全関係者 | 1ページ要約 | 標準Writing Rules |
+
+## 📝 Qiita記事生成時の追加ルール（v1.21.0）🆕
+
+> **WHEN**: レポートタイプが「技術記事（Qiita）」の場合
+> **DO**: `shikigami-writing` スキルの **Qiita Writing Rules** セクションを適用
+
+### 必須適用事項
+
+| 項目 | ルール |
+|------|--------|
+| **フロントマター** | title, tags, private, updated_at を必ず含める |
+| **タグ** | 1〜5個、メイン+技術+カテゴリ+トレンドの組み合わせ |
+| **タイトル** | 30〜50文字、キーワード前半配置、数字で訴求 |
+| **構成** | はじめに→前提条件→本文→まとめ→参考資料 |
+| **記法** | `:::note info/warn/alert`、ファイル名付きコードブロック |
+| **文字数** | 2,000〜5,000文字（読了時間5-15分） |
+
+### Qiita品質チェックリスト
+
+```
+☐ フロントマター完備（title, tags, private）
+☐ タイトル50文字以内
+☐ タグ1〜5個
+☐ はじめにセクションに対象読者・得られる知識
+☐ コードブロックにファイル名付与
+☐ 参考資料にURL付き
+☐ 動作確認済みコード
+```
+
+詳細: [shikigami-writing SKILL.md](../skills/shikigami-writing/SKILL.md#qiita-writing-rules)
 
 ## 📋 生成プロセス
 

package/.github/skills/configs/auto-invoke-triggers.yaml

@@ -1,11 +1,59 @@
 # auto-invoke-triggers.yaml
-# v1.19.0 - 自動呼出しトリガーマッピング
+# v1.22.0 - 自動呼出しトリガーマッピング
 # REQ-FW-FIN-002, REQ-QA-AUTO-001, REQ-QA-AUTO-002, REQ-FW-RISK-001, REQ-FW-SRC-001, REQ-FW-STK-001, REQ-FW-KPI-001 実装
 #
 # 用途: ワークフロー全フェーズの自動呼出しトリガーとマッピングを定義
 # 参照元: 各SKILL.md (planner, deep-research, consulting-framework, writing)
 
-version: "1.19.0"
+version: "1.22.0"
+
+# ========================================
+# Qiita記事作成（ショートカットワークフロー）v1.22.0 NEW!
+# ========================================
+qiita_article:
+  prompt: "shikigami-qiita-article.prompt.md"
+  description: "Qiita記事を直接作成（Qiita Writing Rules強制適用）"
+  priority: "P0"
+  skill: "shikigami-writing"
+  
+  triggers:
+    - type: "keyword_match"
+      keywords:
+        - "Qiita記事"
+        - "Qiita"
+        - "技術記事"
+        - "技術ブログ"
+        - "Qiitaに投稿"
+        - "Qiita用"
+        - "Qiita向け"
+        - "qiita article"
+        - "tech article"
+        - "post to qiita"
+      match_type: "any"
+    
+    - type: "explicit_command"
+      commands:
+        - "@qiita"
+        - "@shikigami-qiita"
+        - "Qiita記事作成"
+        - "技術記事作成"
+  
+  invoke_at: "immediate"
+  
+  required_rules:
+    - rule: "qiita_writing_rules"
+      description: "Qiita Writing Rulesを強制適用"
+      reference: "shikigami-writing/SKILL.md#qiita-writing-rules"
+    - rule: "frontmatter_required"
+      description: "フロントマター必須（title, tags, private）"
+    - rule: "title_max_50_chars"
+      description: "タイトル50文字以内"
+    - rule: "tags_1_to_5"
+      description: "タグ1〜5個"
+    - rule: "file_name_in_codeblock"
+      description: "コードブロックにファイル名付与"
+  
+  output_format: "qiita_markdown"
 
 # ========================================
 # 0. Phase 0: プロジェクト初期化（ワークフロー開始点）v1.17.0 NEW!
@@ -62,7 +110,7 @@ project_initialization:
     condition: "project_initialization.complete == true"
 
 # ========================================
-# 0.5. Phase 0.5: 構造化プロンプト生成（v1.19.0 NEW!）
+# 0.5. Phase 0.5: 構造化プロンプト生成（v1.19.0 NEW! / v1.22.0 Updated）
 # ========================================
 prompt_refinement:
   prompt: "shikigami-purpose-discovery.prompt.md"
@@ -77,6 +125,75 @@ prompt_refinement:
   
   invoke_at: "after_phase_0"
   
+  # v1.22.0: プロンプト保存アクション
+  prompt_saving:
+    enabled: true
+    save_directory: "prompts/"
+    
+    # 元のプロンプトを保存
+    original_prompt:
+      filename: "original-prompt.md"
+      save_at: "phase_0.5_start"
+      format: |
+        ---
+        timestamp: "{timestamp}"
+        project_id: "{project_id}"
+        ---
+        
+        # Original Prompt
+        
+        {user_input}
+    
+    # 構造化プロンプトを保存
+    structured_prompt:
+      filename: "structured-prompt.md"
+      save_at: "phase_0.5_approved"
+      format: |
+        ---
+        timestamp: "{timestamp}"
+        project_id: "{project_id}"
+        version: {version}
+        approved: {approved}
+        ---
+        
+        # Structured Prompt
+        
+        ## PURPOSE（目的）
+        {purpose}
+        
+        ## TARGET（調査対象）
+        {target}
+        
+        ## SCOPE（調査範囲）
+        {scope}
+        
+        ## TIMELINE（時間軸）
+        {timeline}
+        
+        ## CONSTRAINTS（制約条件）
+        {constraints}
+        
+        ## DELIVERABLES（期待する成果物）
+        {deliverables}
+    
+    # 修正履歴を保存（修正があった場合のみ）
+    refinement_history:
+      filename: "refinement-history.md"
+      save_at: "on_refinement"
+      append: true
+      format: |
+        
+        ---
+        
+        ## Refinement {version} - {timestamp}
+        
+        **変更箇所**: {changed_elements}
+        
+        **変更理由**: {reason}
+        
+        **変更内容**:
+        {changes}
+  
   # 構造化プロンプト生成ルール
   structured_prompt:
     enabled: true

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

@@ -90,37 +90,223 @@ license: MIT
 
 ---
 
+## Qiita Writing Rules（v1.21.0）🆕
+
+### フロントマター（必須）
+
+```yaml
+---
+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                  # 任意: スライドモード
+---
+```
+
+### タグ選定ルール
+
+| ルール | 説明 | 例 |
+|--------|------|-----|
+| **メインタグ** | 記事の主題（1個） | `Python`, `React`, `AWS` |
+| **技術タグ** | 使用技術（1-2個） | `TypeScript`, `Docker` |
+| **カテゴリタグ** | 記事種別（1個） | `初心者向け`, `ポエム`, `Tips` |
+| **トレンドタグ** | 旬のタグ（0-1個） | `ChatGPT`, `Copilot` |
+
+**禁止事項**:
+- 同義タグの重複（`JavaScript`と`JS`両方）
+- 関連性の薄いタグ
+- 5個を超えるタグ
+
+### タイトル最適化
+
+| 要素 | ルール |
+|------|--------|
+| **文字数** | 30〜50文字（50文字超は検索で切れる） |
+| **キーワード** | 主要キーワードを前半に配置 |
+| **数字** | 具体的数字で訴求（「5つの方法」「3ステップ」） |
+| **ターゲット** | 対象読者を明示（「初心者向け」「実務で使える」） |
+
+**良い例**:
+- ✅ `【2026年版】GitHub Copilot完全ガイド｜実務で使える10のTips`
+- ✅ `Python初心者が3日でWebアプリを作る方法【Flask入門】`
+
+**悪い例**:
+- ❌ `Pythonについて`（抽象的すぎる）
+- ❌ `私がReactを学んで感じた様々なことについての考察と今後の展望`（長すぎる）
+
+### 記事構成ガイドライン
+
+| セクション | 必須 | 目安文字数 | 内容 |
+|-----------|:---:|-----------|------|
+| **はじめに** | ✅ | 200-400字 | 記事の目的、対象読者、得られる知識 |
+| **前提条件** | △ | 100-200字 | 環境、必要知識、バージョン情報 |
+| **本文** | ✅ | 1500-4000字 | 複数セクションに分割（H2/H3） |
+| **まとめ** | ✅ | 200-300字 | 要点整理、次のステップ |
+| **参考資料** | ✅ | - | URL付きリンク |
+
+**推奨総文字数**: 2,000〜5,000文字（読了時間5-15分）
+
+### Qiita記法リファレンス
+
+#### 注釈ボックス
+
+```markdown
+:::note info
+💡 **ポイント**: 補足情報・Tips
+:::
+
+:::note warn
+⚠️ **注意**: 警告・落とし穴
+:::
+
+:::note alert
+🚨 **重要**: 致命的な注意点
+:::
+```
+
+#### コードブロック
+
+```markdown
+```python:main.py
+# ファイル名を表示
+def hello():
+    print("Hello, Qiita!")
+```
+
+```diff:変更点
+- old_code()
++ new_code()
+```
+```
+
+#### 折りたたみ
+
+```markdown
+<details><summary>クリックで展開</summary>
+
+長いコードや補足情報
+
+</details>
+```
+
+#### 数式（KaTeX）
+
+```markdown
+インライン: $E = mc^2$
+
+ブロック:
+$$
+\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
+$$
+```
+
+#### リンクカード
+
+```markdown
+https://qiita.com/example/items/xxxxx
+（URLを単独行に書くとカード表示）
+```
+
+### 品質チェックリスト
+
+| チェック項目 | 基準 |
+|-------------|------|
+| ☐ タイトル | 50文字以内、キーワード前半配置 |
+| ☐ タグ | 1〜5個、適切なタグ選定 |
+| ☐ はじめに | 対象読者・得られる知識を明記 |
+| ☐ コードブロック | ファイル名付き、シンタックスハイライト |
+| ☐ 画像 | alt属性付き、適切なサイズ |
+| ☐ 参考資料 | すべてURL付き |
+| ☐ 誤字脱字 | チェック済み |
+| ☐ 動作確認 | コードは実行確認済み |
+
+### SEO最適化
+
+| 要素 | 最適化方法 |
+|------|-----------|
+| **タイトル** | 検索されやすいキーワードを含める |
+| **冒頭100文字** | 記事の要約（検索結果に表示される） |
+| **見出し** | H2/H3にキーワードを含める |
+| **画像** | 説明的なalt属性を付与 |
+| **内部リンク** | 関連する自分の記事へリンク |
+
+---
+
 ## Qiita記事テンプレート
 
 ```markdown
-# [タイトル]（50文字以内）
+---
+title: "[タイトル]（50文字以内）"
+tags: Tag1, Tag2, Tag3
+private: false
+updated_at: ''
+id: null
+organization_url_name: null
+slide: false
+---
+
+# はじめに
+
+**この記事で分かること**:
+- ポイント1
+- ポイント2
+- ポイント3
 
-## はじめに
-**この記事で分かること**: [ポイント]
 **想定読者**: [読者層]
 
 :::note info
-所要時間: 約X分 / 難易度: 初級/中級/上級
+📖 **所要時間**: 約X分
+🎯 **難易度**: 初級/中級/上級
+💻 **環境**: Node.js 20+, TypeScript 5.x
 :::
 
-## セクション
+## 前提条件
+
+- 前提知識1
+- 前提知識2
+
+## セクション1
+
 [内容]
 
-```python:sample.py
-# ファイル名付きコードブロック
+```typescript:example.ts
+// ファイル名付きコードブロック
+const greeting = "Hello, Qiita!";
+console.log(greeting);
 ```
 
 :::note warn
 **注意**: [重要な注意点]
 :::
 
-<details><summary>詳細（クリックで展開）</summary>
-[長い内容]
+## セクション2
+
+[内容]
+
+<details><summary>📝 詳細な説明（クリックで展開）</summary>
+
+長い内容や補足情報
+
 </details>
 
 ## まとめ
+
+| ポイント | 内容 |
+|---------|------|
+| 1 | 要点1 |
+| 2 | 要点2 |
+| 3 | 要点3 |
+
+**次のステップ**: [次に学ぶべきこと、関連記事へのリンク]
+
 ## 参考資料
-<!-- URL必須 -->
+
+- [参考資料1](https://example.com) - 説明
+- [参考資料2](https://example.com) - 説明
+- [公式ドキュメント](https://example.com)
 ```
 
 ---