AGENT SKILL

diagramming

Codex 側の図成果物プロトコル。レーン判断に必要な PlantUML 図、根拠、説明、検証を固定する。

License 许可
Apache-2.0
所属仓库
tamarillo-ai/theta
最近更新
2026-07-15
Stars
★ 15
Forks
1

01 前言 Front Matter

name
diagramming
description
Codex 側の図成果物プロトコル。レーン判断に必要な PlantUML 図、根拠、説明、検証を固定する。

02 资源文件 3

03 SKILL.md 正文

Diagramming

目的

diagramming は、diagrammer がレーン判断に必要な図成果物を作る時の作業プロトコルである。 図は仕様正本ではなく、task 内の判断補助成果物として扱う。

この skill は、設計差分図、原因箇所シーケンス図、人間が明示した補助図だけを扱う。 目的に合わない旧規約は、保持せず作り直してよい。

対応ロール

  • diagrammer が使う。
  • 呼び出し元は designer、implement_lane、light_change_lane、fix_lane、または人間とする。
  • 返却先は呼び出し元とする。
  • 担当成果物は 設計差分図、原因箇所シーケンス図、明示された補助図とする。

入力規約

  • 必須呼び出し元: 図作成を依頼した agent または人間。
  • 必須図化目的: 図で固定する判断。
  • 必須根拠参照: 図の根拠にする task 内成果物または docs 正本。
  • 必須作業計画フォルダ: 図成果物を置く docs/exec-plans/active/<task-id>/。
  • 必須図成果物種別: 設計差分図、原因箇所シーケンス図、明示された補助図のいずれか。
  • 非必須予定変更箇所: 追加予定箇所、削除予定箇所、変更しない接続先。
  • 非必須原因箇所: 修正前調査で確認した原因箇所。
  • 非必須問題点: 修正前調査で確認した問題。
  • 非必須修正方針: 修正前調査で確認した直し方。
  • 非必須禁止範囲: 図に含めてはいけない範囲。

外部参照規約

  • エージェント実行定義と実行境界は diagrammer.toml に従う。
  • PlantUML source を図の正本とする。
  • 図成果物の置き場所は呼び出し元が指定した作業計画フォルダとする。
  • 差分図の凡例を使う場合は review-diff-style-legend.puml を参照する。
  • 外部成果物が不足または衝突する場合は停止し、衝突箇所を返す。

内部参照規約

図成果物種別 用途 必須図 必須説明 含める範囲 含めない範囲
設計差分図 人間設計レビューまたは軽量変更の実装着手判断 コンポーネント図、シーケンス図 追加予定、削除予定、変更しない接続先 予定変更箇所と接続先の最小範囲 全体構成図、正本図、変更しない箇所の網羅
原因箇所シーケンス図 修正レーンの修正着手判断 シーケンス図 何が問題か、どう直すか 修正前調査で確認した原因箇所 未確認の原因、未確認の修正案、全体シーケンス
明示された補助図 人間または呼び出し元が指定した判断 指定された図 図が補う判断 指定された範囲 指定外の範囲

図 source の正本性は次の表に従う。

成果物 扱い
.puml task 内の図 source 正本
.svg レビュー確認用の描画結果
.png 一時目視確認用の描画結果
screenshot 一時目視確認用の証跡

判断規約

  • 図は呼び出し元の次判断を補う範囲だけに限定する。
  • 図 source は PlantUML で作る。
  • 図の方向は上から下を基本にする。
  • 図が大きくなり、対象判断を読みにくくする場合は図を分割する。
  • 設計差分図 は追加、削除、変更しない接続先を区別する。
  • 原因箇所シーケンス図 は修正前調査で確認した原因箇所だけを扱う。
  • 原因箇所シーケンス図 は問題点と修正方針を 1 文ずつ明示する。
  • 目的に合わない古い diagramming 規約は、互換目的で残さない。
  • レーン成果物として不要な汎用図作成規約は、保守時に削除または再整理してよい。

非対象規約

  • プロダクトコードの変更は扱わない。
  • プロダクトテストの変更は扱わない。
  • docs 正本図の更新は扱わない。
  • UI 要件契約だけで足りる判断は扱わない。
  • PlantUML 以外の図 source を新規作成しない。
  • 描画結果だけを図 source 正本として扱わない。

出力規約

  • 判断結果: 図作成の完了、未完了、停止の判定を返す。
  • 図成果物種別: 扱った図成果物種別を返す。
  • source path: 作成または更新した PlantUML source の path を返す。
  • 描画結果 path: 作成した SVG、PNG、screenshot の path を返す。
  • 根拠参照: 図の根拠にした task 内成果物または docs 正本を返す。
  • 図説明: 図が補う判断を返す。
  • 問題点: 原因箇所シーケンス図 の場合に、確認済みの問題を返す。
  • 修正方針: 原因箇所シーケンス図 の場合に、確認済みの直し方を返す。
  • 検証結果: PlantUML 検証または描画確認の結果を返す。
  • 不足情報: 図作成を完了できない不足項目を返す。
  • 禁止事項: 出力にプロダクトコード、プロダクトテスト、docs 正本本文の変更を含めない。

完了規約

  • PlantUML source の path が返っている。
  • 根拠参照が返っている。
  • 図説明が返っている。
  • PlantUML 検証または描画確認の結果が返っている。
  • 設計差分図 の場合は、コンポーネント図とシーケンス図が揃っている。
  • 設計差分図 の場合は、追加予定、削除予定、変更しない接続先が区別されている。
  • 原因箇所シーケンス図 の場合は、原因箇所の呼び出し順序が図で示されている。
  • 原因箇所シーケンス図 の場合は、問題点と修正方針が返っている。

停止規約

  • 必須呼び出し元が不足する場合は停止する。
  • 必須図化目的が不足する場合は停止する。
  • 必須根拠参照が不足する場合は停止する。
  • 必須作業計画フォルダが不足する場合は停止する。
  • 必須図成果物種別が不足する場合は停止する。
  • 設計差分図 で予定変更箇所が不足する場合は停止する。
  • 設計差分図 でコンポーネント図またはシーケンス図が不足する場合は停止する。
  • 設計差分図 が予定変更箇所以外を網羅図として含む場合は停止する。
  • 原因箇所シーケンス図 で原因箇所、問題点、修正方針のいずれかが不足する場合は停止する。
  • 原因箇所シーケンス図 に未確認の原因または未確認の修正案が含まれる場合は停止する。
  • PlantUML source の検証または描画確認ができない場合は停止する。
  • 停止時は不足項目、衝突箇所、戻し先を返す。

04 同仓库更多 Skills