Skip to content

feat(cctrace): rename to Context Causality Trace, add model/effort presets - #3

Merged
tukuyomil032 merged 2 commits into
mainfrom
docs/rename-cctrace-and-model-config
Aug 8, 2026
Merged

feat(cctrace): rename to Context Causality Trace, add model/effort presets#3
tukuyomil032 merged 2 commits into
mainfrom
docs/rename-cctrace-and-model-config

Conversation

@tukuyomil032

@tukuyomil032 tukuyomil032 commented Aug 8, 2026

Copy link
Copy Markdown
Owner

背景・課題

cctrace は Codex CLI 対応が済んだが、正式名称が旧来の「Claude Code Trace」的な想定のままで、Codex 対応を反映していなかった。また SKILL.ja.md に関西弁が混入しており、ドキュメントとして不適切だった。

加えて、.cctrace/config.jsoncodex_model は生のモデルID文字列を直書きする方式で、reasoning effort を指定する手段が一切なかった。Claude 側の model も生モデルIDの直書きで、ユーザーが選びやすいエイリアスがなかった。

方針・変更内容

  • 正式名称を Context Causality Trace(略称 cc/cctrace は維持)とし、SKILL.md / SKILL.ja.md のタイトル行に併記
  • SKILL.ja.md の関西弁を標準語に修正
  • .cctrace/config.json のスキーマを変更:
    • model: 生モデルIDではなく Claude 用エイリアス(sonnet-4.6 / sonnet-5
    • codex_model を廃止し codex_presetpattern1 = Luna/gpt-5.6-luna/high, pattern2 = Terra/gpt-5.6-terra/low)に置き換え。プリセットの中身は hooks/hook-utils.nu に固定テーブルとして定義し、必要なら config.json を直接編集して上書き可能
  • hook-utils.nuclaude-model-alias / config-codex-preset を追加し、summarize()-c model_reasoning_effort=<level> を渡せるよう拡張
  • インストール済み共有先 ~/.agents/skills/cctrace/(Claude Code / Codex CLI 双方が参照)にも変更を同期

却下した代替: pattern1/pattern2 それぞれ2案(例: pattern1 = Luna/high or Terra/medium)が候補にあったが、選択メニューを複雑にしすぎないため固定の組み合わせ1つをデフォルト採用とし、別の組み合わせが欲しい場合は config.json 直編集で対応する設計にした。

影響範囲

  • cc-trace/ スキルのみ。video-frame-reader / ci-monitoring には影響しない
  • .cctrace/ ディレクトリ構造・アーカイブ命名規則は変更しない
  • codex_model キーとの後方互換は持たせていない(config.json に手動で書かれていた場合は再設定が必要)

検証

  • cd cc-trace && uv run --with pytest python -m pytest tests/ -q — 80件パス
  • bash cc-trace/tests/test_hooks_nu.sh — 52件パス
  • 実機の codex exec(codex-cli 0.147.0)で -m gpt-5.6-luna -c model_reasoning_effort=high / -m gpt-5.6-terra -c model_reasoning_effort=low を実行し、起動バナーの model: / reasoning effort: 表示で反映を確認

関連 Issue

Closes #

メモ

このPRには、リポジトリ用の CONTRIBUTING.md.github/pull_request_template.md の追加(tukuyomil032/embed-preview を土台にこのリポジトリ向けへ最適化したもの)も含まれる。既に main へ直接コミット・pushしてあり、このブランチにはマージ済み。このPR自体の説明も、新設したテンプレートの形式に従って書いている。

🤖 Generated with Claude Code

Summary by CodeRabbit

  • 新機能

    • Claude Code と Codex CLI でモデル設定を個別に管理できるようになりました。
    • Codex のプリセットからモデルと推論強度を自動設定します。
    • ホストに応じた設定を読み込み、Codex 実行時に適切なオプションを適用します。
    • Codex hooks の有効化手順と既定設定を更新しました。
  • ドキュメント

    • Claude Code と Codex の共有運用、設定方法、実行手順を更新しました。

tukuyomil032 and others added 2 commits August 8, 2026 15:13
…sets

SKILL.ja.md の関西弁を標準語に修正し、cctrace の正式名称として Context Causality Trace を両言語版のタイトルに併記。Claude 側は model エイリアス(sonnet-4.6/sonnet-5)、Codex 側は codex_preset(pattern1=Luna/high, pattern2=Terra/low)で GPT-5.6 モデル+reasoning effort を選べるよう config.json スキーマを拡充した。

hook-utils.nu にエイリアス解決・プリセット解決ロジックを追加し、summarize() が -c model_reasoning_effort を渡せるよう変更。実機の codex exec で -m/-c の組み立てを検証済み。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Claude と Codex のモデル設定を分離しました。Codex は codex_preset からモデルと reasoning effort を解決します。フックはホスト別設定を読み込み、Codex 実行時に必要な CLI 設定を渡します。テストは各ホストのフォールバックと設定分離を検証します。

Changes

Codex プリセット対応

Layer / File(s) Summary
ホスト別設定と実行手順
cc-trace/SKILL.md, cc-trace/SKILL.ja.md
Claude 用 model エイリアスと Codex 用 codex_preset の設定形式、既定値、モデルと reasoning effort の対応を追加しました。cctrace:run のホスト別実行手順も更新しました。
プリセット解決と要約実行
cc-trace/hooks/hook-utils.nu, cc-trace/hooks/precompact-auto.nu
Claude のモデルエイリアスと Codex のプリセットを実モデル ID に解決します。Codex の effort が指定された場合は model_reasoning_effortcodex exec に渡します。
ホスト別設定の検証
cc-trace/tests/test_hooks_nu.sh
Codex のプリセット解決、Claude 設定との分離、未知または null の設定時のフォールバックを検証します。

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant precompact-auto.nu
  participant hook-utils.nu
  participant summarize
  participant Codex CLI
  precompact-auto.nu->>hook-utils.nu: codex_preset から effort を取得
  precompact-auto.nu->>summarize: モデルと effort を渡す
  summarize->>Codex CLI: model_reasoning_effort を付けて実行
  Codex CLI-->>summarize: 要約結果を返す
Loading

Possibly related PRs

  • tukuyomil032/skills#2: Codex ホスト対応を追加した変更であり、本変更は共有設定と要約実行を拡張します。

Poem

うさぎが跳ねて、設定を分ける
Claude は別名、Codex は preset
モデルと effort が仲良く並ぶ
フックは静かに値を渡す
テストも元気に耳を振る

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed タイトルは正式名称の変更とモデル・推論 effort プリセットの追加という主要な変更を明確に示しています。
Description check ✅ Passed 背景、変更内容、影響範囲、検証結果、メモを含み、テンプレートの主要項目を満たしています。
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/rename-cctrace-and-model-config

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@cc-trace/SKILL.ja.md`:
- Around line 261-267: Update the Codex command examples in cc-trace/SKILL.ja.md
lines 261-267 and cc-trace/SKILL.md lines 262-268 to construct arguments
conditionally: omit both -m and model_reasoning_effort when codex_preset is
unset, while including them when a preset is configured. Keep the examples
executable and apply the same behavior consistently in both files.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 20b23a51-d013-4b28-a6d7-917c0d7e1903

📥 Commits

Reviewing files that changed from the base of the PR and between 464a1e5 and b52ef83.

📒 Files selected for processing (5)
  • cc-trace/SKILL.ja.md
  • cc-trace/SKILL.md
  • cc-trace/hooks/hook-utils.nu
  • cc-trace/hooks/precompact-auto.nu
  • cc-trace/tests/test_hooks_nu.sh

Comment thread cc-trace/SKILL.ja.md
Comment on lines 261 to +267
**Codex** — `--output-last-message` はサマリーを**ファイル**に書くので、後から読み直すこと。
モデルが未設定なら `-m` ごと省略する:
`codex_preset` が未設定なら `-m` と `-c model_reasoning_effort` の両方を省略する:
```bash
tmp=$(mktemp -t cctrace-summary)
python3 <skill-dir>/scripts/process_transcript.py --host codex "<transcript>" "<cwd>" "<detail>" \
| codex exec --skip-git-repo-check -C "<cwd>" -s read-only -m <model> -o "$tmp" -
| codex exec --skip-git-repo-check -C "<cwd>" -s read-only -m <model> \
-c model_reasoning_effort="<effort>" -o "$tmp" -

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

未設定 preset 用のコマンド例を実行可能にしてください。

codex_preset が null の場合も、現在のコード例は -m <model>-c model_reasoning_effort を含みます。直前の省略規則に従う利用者は、このコード例をそのまま実行できません。preset の有無に応じて引数を組み立ててください。

  • cc-trace/SKILL.ja.md#L261-L267: preset 未設定時に -m-c を渡さない条件付きの Codex コマンド例へ変更してください。
  • cc-trace/SKILL.md#L262-L268: 同じ条件付きの Codex コマンド例へ変更してください。
修正例
 tmp=$(mktemp -t cctrace-summary)
+codex_args=()
+if [ -n "$model" ]; then
+  codex_args=(-m "$model" -c "model_reasoning_effort=$effort")
+fi
 python3 <skill-dir>/scripts/process_transcript.py --host codex "<transcript>" "<cwd>" "<detail>" \
-  | codex exec --skip-git-repo-check -C "<cwd>" -s read-only -m <model> \
-      -c model_reasoning_effort="<effort>" -o "$tmp" -
+  | codex exec --skip-git-repo-check -C "<cwd>" -s read-only "${codex_args[@]}" -o "$tmp" -
📍 Affects 2 files
  • cc-trace/SKILL.ja.md#L261-L267 (this comment)
  • cc-trace/SKILL.md#L262-L268
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@cc-trace/SKILL.ja.md` around lines 261 - 267, Update the Codex command
examples in cc-trace/SKILL.ja.md lines 261-267 and cc-trace/SKILL.md lines
262-268 to construct arguments conditionally: omit both -m and
model_reasoning_effort when codex_preset is unset, while including them when a
preset is configured. Keep the examples executable and apply the same behavior
consistently in both files.

@tukuyomil032
tukuyomil032 merged commit 37fc1a3 into main Aug 8, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant