tracker-bridge Agent README

人間向けの概要は README-human.md を参照してください。

同梱 Skill

• Skill 名: $tracker-bridge-materials
• 格納先: skills/tracker-bridge-materials/
• 入口: skills/tracker-bridge-materials/SKILL.md

最初に読む順番

順番	ファイル
1	skills/tracker-bridge-materials/SKILL.md
2	BLUEPRINT.md
3	docs/kv-priority-roadmap/

必要になった時だけ参照: GUARDRAILS.md / RUNBOOK.md / docs/tracker-bridge-requirements.md / docs/tracker-bridge-sqlite-spec.md / README-human.md

実施ルール

項目	ルール
優先順	P1 -> P2 -> P3 -> P4 を崩さない
typed_ref	新規出力は 4 セグメント canonical
疎結合	agent-taskstate / memx-core とは typed_ref による論理参照のみ
秘密情報	認証情報を DB に保存しない

GitHub outbound

TrackerIntegrationService.create_outbound_issue は connection ID、task ID、 handoff ID、handoff item ID、title、body、labels を受け取ります。

• local ref は agent-taskstate:task:local:<task_id>
• remote ref は tracker:issue:github:<owner/repo#number>
• fingerprint と非表示 marker で再送・同時送信を抑止
• token は tracker_connection.secret_ref が示す環境変数だけから取得
• applied 時は issue cache、entity link、sync event を同一 transaction で確定
• outcome unknown は自動再作成せず照合・review対象

検証

pip install -e ".[dev]"
ruff check .
mypy tracker_bridge tests
pytest
pytest --cov

参照

• RUNBOOK.md
• EVALUATION.md
• docs/tracker-bridge-requirements.md
• docs/tracker-bridge-sqlite-spec.md