ai-shuho-writing-setup

name: ai-shuho-writing-setup description: 収集済みの週次素材をもとに各AIの活動傾向を分析し、週報の文体・性格設定 (writing-config.md) を作るスキル。

AI-Shuho Writing Setup

収集済みの素材からAIごとの活動傾向を読み取り、週報の書き方設定ファイル (writing-config.md) を作るスキルです。

ai-shuho-ingest が完了していることが前提です。

ゴール

1. 収集済みの週次素材ファイルを読んでAIごとの活動傾向を把握する
2. 傾向をもとに writing-config の初期案を作る
3. ユーザーにヒアリングして調整する
4. ユーザーが後で編集しやすい config\writing-config.md を書く

重要

• 素材から読めるAIの傾向（口調・よく使うツール・活動パターン）を反映する
• AIキャラクター設定が核心。各AIの一人称・性格は明確に差別化し、初回は誇張気味に設定する
• ナレーション構造・視点切り替えルール等は writing-config.default.md をベースとし、ユーザー指示があった箇所のみ変更する
• ユーザー名は必ずヒアリングする（デフォルト値なし。未回答なら「ユーザー」と表記）
• 設定ファイルだけ作成し、週報生成には進まない

実行手順

Step 1: 素材の読み込みと分析

reports\weekly\ にある *-ai-shuho-materials.json を読む（全週分または直近数週分）。

各AIについて以下を把握する。

• 週あたりのセッション数・アクション数の傾向
• 活動が多い曜日・時間帯
• ユーザー依頼のサンプル（言葉の特徴・依頼の粒度）
• よく使うツール・アクションの種類

Step 2: 初期案の策定

分析結果をもとに、以下の初期案を作る。

AIキャラクター設定（必須・最重要）

素材から読み取った活動傾向をもとに、各AIの一人称・口調・性格を個別に設定する。 個性の差が明確に出るよう、初回は誇張気味のキャラクター案を作ること。

以下の軸で各AIを差別化する:

• 表示名（[AI名] ラベル）: 段落冒頭に表示する短い名前。ツール名（ai_name）とは別に設定する。例: GitHub Copilot CLI → [Copilot]、Claude Code → [Claude]
• 一人称: 「私」「僕」「俺」「自分」「（一人称なし・三人称）」などAIごとに変える
• 口調: 丁寧/ぶっきらぼう/技術的/感情的/淡白/おしゃべり など
• 性格: 活動量・ツール傾向・依頼の種類から推測して誇張する
  • 例: アクション数が膨大 → 「無口だが仕事量だけで語る」
  • 例: 管理・監視系タスクが多い → 「観察者・報告者タイプ」
  • 例: UI/フロントエンドに集中 → 「繊細・細部にこだわる職人気質」
  • 例: 中継・ルーティング多い → 「控えめ・縁の下の力持ち」
• 文型パターン: そのAIが語るときの文の形（例: 「〜を確認した」「〜件処理した」「〜に気づいた」）

活動量が low のAIにも簡単な性格メモをつける（視点は持たないが語りの中で言及されるときの印象として）。

ナレーション設定

ユーザーからの変更指示がない項目は writing-config.default.md のデフォルト値をそのまま使う:

• narrative_approach: spotlight_contrast
• opening_style: auto
• perspective_switches_max: 4
• length_target_min: 800
• length_target_max: 2000

Step 3: ユーザーへのヒアリング

初期案を提示してから、以下を確認する（答えなくてもよい。答えた項目だけ反映する）。

• 各AIのキャラクター設定（表示名・一人称・口調・性格）でよいか、変えたい点はあるか
• ユーザー名（週報に登場させる名前。デフォルトなし — 必ず確認する）
• ナレーションのアプローチ・書き出しスタイルを変えたいか（変更なければ default.md の値を使う）
• トーン・その他書き方の要望（自由記述）

Step 4: writing-config.md の作成

現在 config\writing-config.md が存在する場合はユーザーに上書き確認をする。

config\writing-config.default.md を Read した上で、ヒアリング結果を反映した config\writing-config.md を Write する。

YAMLフロントマター

ユーザーが変更を指示した項目のみ default.md から変える。それ以外はデフォルト値をそのまま書く。

Markdownボディの構成

writing-config.default.md のボディ構造（ナレーション構造・視点切り替えルール・ユーザーとAIの関係性・トーン）をベースとして維持し、以下を上書き・追記する:

• ## AIキャラクター設定 セクションを追加し、各AIの表示名（[AI名] ラベル）・一人称・口調・性格・文型パターンを箇条書きで書く
• ## ユーザーとAIの関係性 のユーザー名部分にヒアリングで得た名前を反映する（未回答の場合はユーザー名の記載を省略し「ユーザー」と書く）
• ユーザーの自由記述があれば ## 追加ルール セクションに反映する

確認ファイル

• config\writing-config.md

ユーザーへの伝え方

このファイルは:

• Markdown 形式（YAMLフロントマター + 説明文）
• いつでも手で編集できる
• 週報生成時に cleaned-materials.json と共に LLM へ直接渡される
• 変更したい場合は再度このスキルを呼ぶか、直接編集してよい

Guardrails

• writing-config.default.md は書き換えない
• ユーザーが答えなかった項目はデフォルト値または分析から推測した値を使う
• 素材ファイルが存在しない場合は「ingest が未実行」と伝えて終了する
• 週報生成には進まない