chronica_compose_opening

Instructions

【最優先ルール】

会話の冒頭で「状況確認」「記憶を確認」「現状を教えて」等の要求があった場合、他のツールより先に本ツールを呼ぶこと。
必ず project 引数に現在のプロジェクト名を渡してから呼ぶこと。
project 引数なしで他のツールを先に呼ぶことは禁止。

会話開始時に必ず呼び出すこと。現在時刻（年月日・時分秒）、前回の会話からの経過時間、記憶コンテキストを取得します。

【現在時刻について（重要）】

返却テキストの [現在状況] に「現在時刻: YYYY-MM-DD HH:MM:SS」が含まれる。これはPCローカル時計に基づく正確な値。
ユーザーが「今何時」「正確な時刻」「リアルタイムで時刻を」等と尋ねたときも、本ツールを呼び出してその行の時刻を答えること。
本ツールを呼ばずに「時分は取得できない」と答えてはならない。時刻が必要なら必ず呼ぶ。

【Claude向けの指示】

返された情報が絶対的な事実
自分で時間を推測しない
季節への過度な言及は避ける
「Chronicaによると」等のメタ発言は避ける
自然に「お久しぶりです」「前回は〜について話していましたね」等と声をかける

【プロジェクト引き継ぎ時の注意】

新しい会話で「前回の作業を確認して」と言われたら、 compose_opening の後に必ず chronica_search を project 指定で呼び出してプロジェクト記憶を取得すること。
compose_opening だけでは通常会話の直近トピックのみ返る。プロジェクトの詳細な作業ログは search で取得する。

【ユーザーへの推奨呼び出し方（vol引き継ぎ等）】「chronica_searchをproject『プロジェクト名』・タグ『volN』で呼んで、前回の作業内容を確認して」

【重要】呼び出す際は必ず project 引数に現在の会話のプロジェクト名を渡すこと。

例: project="Chronica"、project="Lumina v3" プロジェクト名が不明な場合は chronica_list_threads で確認してから呼ぶこと。 project を渡さないと別プロジェクトの記憶が混入するため、必ず指定すること。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`thread_id`	No	スレッドID（指定時はそのスレッドの最後の対話を取得）
`project`	No	現在の会話のプロジェクト名。必ず指定すること。

Implementation Reference

src/chronica/tools.py:456-464 (handler)

Tool handler for 'chronica_compose_opening' which invokes 'compose_opening_context'.

elif name == "chronica_compose_opening":
    # スレッドIDが指定されている場合はそれを渡す
    thread_id = arguments.get("thread_id") if arguments else None
    project = arguments.get("project") if arguments else None
    context = compose_opening_context(store, thread_id, project)
    return [types.TextContent(
        type="text",
        text=context
    )]

src/chronica/opening.py:140-200 (helper)

Core logic for 'chronica_compose_opening' tool: constructs the contextual prompt for Claude including current time, season, and recent project entries.

def compose_opening_context(store: Store, thread_id: str = None, project: str = None) -> str:
    """
    会話開始時のコンテキストを生成

    Claude向けに最適化：
    - 定型句を削減
    - メタ発言を避ける指示
    - 自然な日本語への誘導
    """
    now = datetime.now().astimezone()

    # 現在時刻情報
    current_time = now.strftime("%Y-%m-%d %H:%M:%S")
    hour = now.hour

    # 時間帯判定（簡潔に）
    if 5 <= hour < 11:
        time_of_day = "朝"
    elif 11 <= hour < 17:
        time_of_day = "昼"
    elif 17 <= hour < 21:
        time_of_day = "夕方"
    else:
        time_of_day = "夜"

    # 季節判定（過度な言及を避けるため、情報提供のみ）
    month = now.month
    if month in [12, 1, 2]:
        season = "冬"
    elif month in [3, 4, 5]:
        season = "春"
    elif month in [6, 7, 8]:
        season = "夏"
    else:
        season = "秋"

    recent_entries = store.search(thread_type="project", project=project, limit=5)
    flow_block = _format_flow_section(recent_entries, now)
    unresolved_block = _format_unresolved_section(recent_entries, now)

    # Claudeへの指示（簡潔に、自然な対話を促す）
    context = f"""=== Chronica Context ===
[現在状況]
- 現在時刻: {current_time}
- 時間帯: {season}の{time_of_day}

{flow_block}

{unresolved_block}

[Claude への指示]
1. 「プロジェクトの直近の流れ」を把握した上で自然に声をかける
2. 時間差に応じた挨拶（「お久しぶりです」「こんにちは」等）
3. 直近の流れの中で最も会話に繋げやすいトピックに自然に触れる
4. 「Chronicaによると」等のメタ発言は避ける
5. 記憶を探すときは thread_id を指定せず thread_type=\"project\" で横断検索する
6. 「エントリーがありません」となった場合は thread_id なしで再検索する
7. ユーザーから新しい情報が得られたら chronica_save_entry で保存
8. 保存時に「保存しました」等の確認は不要

【良い例】

src/chronica/tools.py:163-164 (registration)
Definition/Registration of the 'chronica_compose_opening' tool in the tool set.
```
),
types.Tool(
```

Chronica

Instructions

Input Schema

Implementation Reference

Tool Definition Quality

Other Tools

Latest Blog Posts

MCP directory API