生物学的プロセスステップ図 — 複合プレイブック
生物学、生体材料、組織工学、実験室プロセスステップの正確な独立図を生成します。
信頼境界: ソース検証済みのマッピングカードのみが科学的クレームを導入できます。レンダリング検査はマッピングカードへのピクセル準拠を検証しますが、ソースクレームをアップグレードしたり作成したりすることはできません。スタイルや参照画像は科学を決定しません。
構造: 原子 → 分子 → このプレイブック
このスキルは複合体（プレイブック）です。手順自体を含まず、分子（複合体）をオーケストレーションし、分子は明示的に原子（機能）を連鎖させます。
複合体（このプレイブック）: モード選択、分子の実行、判断の保留
└─ composites/: スコープ化されたワークフロー、明示的な原子の順序（各2～6原子）
└─ capabilities/: 単一目的プリミティブ、ほぼ決定論的
深さは意図的に2レベルに制限されています。分子は原子を直接呼び出し、原子は他の原子を呼び出さず、プレイブックは分子を超えません。より深いグラフはエージェントの信頼性が低下する箇所です。
- 原子（
capabilities/）: 1つの目標、1つの成果物、機械的。オーケストレーションに関する判断は行いません。 - 分子（
composites/）: スコープ化されたタスクで、「原子Xを呼び出し、次に原子Yを呼び出す」という明示的な指示を含みます。実行時の意思決定を最小限に抑えます。 - このプレイブック: モード選択、順序付け、エスカレーション、およびすべてを優先する不変条件。
分子マップ
| 分子 | ファイル | 連鎖する原子 |
|---|---|---|
| analyze-project | composites/analyze-project.md | extract-source-text → analyze-entities → build-material-bible → extract-style-sheet（参照がある場合） |
| plan-step | composites/plan-step.md | write-mapping-card → check-mapping-card → ゲート1 |
| render-step | composites/render-step.md | assemble-prompt → render-image → run-probe（予算内で反復） |
| finalize-step | composites/finalize-step.md | fit-labels（+ 要求に応じてbuild-evidence-package） |
受付 — 開始前に質問
タスク開始時に、ファイルに触れる前に、質問ツール（ask）を使用して1ラウンドでユーザー設定オプションを明確にします。
- タスクタイプ — ワークフローをルーティングします（以下の表）。
- タスクモード —
quick（探索、DRAFTのまま）またはverified（最終納品物）。 - ゲート1モード —
strict_verified（人間によるソース確認）またはagent_draft（人間によるゲートなし）。 - ソース — 特許 / 論文 / プロトコル / DOCX / PDF / ペーストされたテキスト；パスまたはファイル。
- 参照画像 — 提供された（スタイルのみ）またはなし。
- ステップあたりの反復予算（デフォルト5レンダリング）。
- 納品物 — PNGのみ、PNG＋ラベル、またはPNG＋ラベル＋証拠パッケージ。
- モデル — デフォルト
qwen-image-3.0-pro、またはカタログ（capabilities/list-image-models.md、scripts/list_image_models.py）を取得してユーザーに選択させる；選択をmodel_choice.jsonに記録します。
ユーザーが1ラウンドで回答できるオプションを推測しないでください。既存のプロジェクトを継続する場合は、以前の回答を再利用します。
オーケストレーション
タスクタイプ → ワークフロールーティング
| タスクタイプ | 実行する分子 | 注意 |
|---|---|---|
| 単一の新しいステップ図 | plan-step → render-step（+ verifiedの場合はfinalize-step） | プロジェクトBibleがまだ存在しない場合のみanalyze-projectを実行 |
| 完全な図セット（複数ステップ） | analyze-project → ステップごと: plan-step → render-step → finalize-step | 完全パイプライン |
| 既存のステップレンダリングの修正 | render-stepのみ | 検証済みカードを再利用；カードが変更された場合のみゲート1を再実行 |
| 承認済みレンダリングのラベル再調整 | finalize-step（fit-labelsのみ） | 再レンダリングなし |
| 証拠/監査パッケージ | finalize-step（build-evidence-packageのみ） | 既存の成果物をインデックス化 |
| スタイル探索/スケッチ | plan-step（agent_draft、最小限）→ render-step | 出力はDRAFT/UNVERIFIEDのまま |
モード
quick— 探索: 最小限のマッピング、agent_draft、人間によるゲートなし、ラベルなし、証拠パッケージなし。出力はDRAFT/UNVERIFIED。verified— 最終納品物: 完全分析、strict_verified ゲート1、ラベリング、ゲート3、オプションの証拠パッケージ。
各分子は名前付き成果物と検証状態で終了します。分子の必須出力をスキップしないでください。DRAFT/UNVERIFIED 出力がある場合は、明示的に述べてください。検証済みとして提示しないでください。
必須入力
- 科学的ソース（特許 / 論文 / プロトコル / DOCX / PDFテキストまたはユーザー説明） — 操作、識別、状態の権威。
- オプションの参照画像（スタイルのみ）。
- タスクモードとゲート1モード。
必須出力
生成されたステップごとに、ワークフローは以下を生成する必要があります。
| ファイル | 分子 | 内容 |
|---|---|---|
project_material_bible.yaml | analyze-project | ステージ0分析（プロジェクトごとに1回） |
stepN_mapping.yaml | plan-step | マッピングカード + 検証ステータス |
stepN_prompt.txt | render-step | 最終プロンプト（逐語的に） |
stepN_vXX.png + .json | render-step | バージョンごとに1つの候補 + メタデータ |
stepN_probe.yaml | render-step | ゲート2プローブ結果 |
stepN_labeled.png | finalize-step | ゲート3後（検証モード） |
ゲート
| ゲート | 場所 | 検証内容 |
|---|---|---|
| ゲート1 | plan-step | マッピングカード ↔ オープンソース（人間、strictモード） |
| ゲート2 | render-step | レンダリング ↔ マッピングカード（固定プローブ） |
| ゲート3 | finalize-step | ラベル ↔ 出荷ピクセル |
このワークフローにおいて、他の成果物は真実のゲートではありません。その他はすべて文書化、衛生、または実行可能な基盤です。
必須不変条件
- ソースは操作、識別、状態に対して権威を持つ。
- 構成のために操作や科学的実体を発明しない。
- 繰り返し現れる実体: プロジェクトごとに1つの正準記述子；識別トークンは、宣言された遷移が変動を正当化しない限り安定。
- 不確かなプロパティは汎用またはOPENのままにする；黙って解決しない。
- スタイルBible / 参照画像 ≠ 科学的証拠。
- トポロジーは検証済みマッピングカードに基づく。
- ラベルと出荷ピクセルは一致する。
- APIの成功 ≠ 視覚的または科学的受容。
- ソースチェックをスキップすると
DRAFT/UNVERIFIEDが生成され、検証済みクレームは生成されない。
リポジトリレイアウト
SKILL.md このプレイブック（複合体）
composites/ 分子
capabilities/ 原子
schemas/ マテリアルBible / マッピングカード / レンダリングメタデータ / プローブ用JSONスキーマ
adapters/ レンダラー固有の契約（dashscope.md）
scripts/ 汎用レンダラー（generate_image.py）
examples/ 作業済み成果物（hydrogel_patent/）
.env.example キーテンプレート；ローカルに.envとしてコピー
拡張
- 新しい単一目的操作 →
capabilities/*.mdを追加し、機械的に保ち、1つのスキーマまたはスクリプトを与える。 - 新しいスコープ化タスク → 既存の原子を連鎖させる
composites/*.mdを追加；新しい原子よりも既存の原子の再利用を優先する。 - 新しいトップレベルジョブ → このプレイブック（または新しいプレイブック）内で分子を構成する。
- 別の原子を呼び出す機能は、定義上、分子です。原子層を深くしないでください。