はじめに
REQ Agent
REQ Agent は要求分析タスクを担当し、要求を実行可能な仕様に変換します。
v3.0.4 (Latest)
リリース日：2026-08-21 | ベースバージョン：v3.0.3
1. 概要
| 項目 | 内容 |
|---|---|
| リリース日 | 2026-08-21 |
| バージョン番号 | v3.0.4 |
| ベースバージョン | v3.0.3 |
2. 報告事項
2.1 新機能
| モジュール | 詳細 |
|---|---|
| 要求分析スキル | ReqAgent 要求エンジニアリング機能（request-analysis）を新規追加。管理された旧版／新版の要求仕様を入力とし、差分レポート、要求分析、分析レビュー、SRS（BDD／SDD-A／検証分析を含む）、最終レビューレポート、編集可能な Excel ワークブックの一式の成果物を自動生成します。トリガーワード：「ReqAgent を実行」「要求差分」「SWE1 レポート」 |
| 要求分析スキル | Word／Excel／PDF／Markdown の旧新ペア入力、追加のみまたは削除のみの単一仕様、および既存変更点リストの検証取り込みをサポート |
| 要求分析スキル | チェックポイント再開とステージジャンプ：自然言語で任意のステージから再開可能。ステージ開始前に当該ステージに必要な前提成果物が揃っているかを自動的に確認し、不足時は架空生成せず明確に不足を報告 |
| 要求分析スキル | 生成とレビューの分離：各生成ステージに独立したレビューを1回付与。レビュー担当は入力と成果物を独立に再検証し生成結果を変更しません。問題発見時は有界な手戻りをトリガーし、再レビューでは各問題を「解決済み／残存／差し戻し」と個別に判定 |
| 要求分析スキル | 無変更判定を厳格化：決定論的差分で無変更が証明できる場合のみ無変更と判定し最小限のクローズを実施。ツール実行失敗は「無変更」として記録せず、架空の SRS、レビューレポート、Excel は生成しません |
| 要求分析スキル | 証拠不足の明示的登録：証拠不十分な場合は Q&A、ギャップ、保留、暫定事項として登録し、プロジェクト事実を補造しません。コードルートディレクトリ未設定時は保留とし、「ナレッジベース未ヒット」を「影響なし」と解釈しません |
| 要求分析スキル | 大規模変更セットの自動並列化：変更点数が並列度を超えると自動的に複数シャードに分割して SRS を並列生成し、決定論的スクリプトでマージ（証拠チェーン連結、要求重複除去、参照リマップ、問題リスト統合）。既定は4並列でプロジェクトに応じて調整可能。変更点が少ない場合は自動的に直列にフォールバックし、成果物は直列と一致 |
| 要求分析スキル | シャード単位の失敗リトライ：1シャードの失敗は当該シャードのみ再実行し、他シャードの完了済み成果には影響しません。リトライ予算は意味的手戻り予算と独立 |
| 要求分析スキル | Excel 成果物はレビュー済み Markdown／JSON の決定論的射影であり、二次的な AI 生成結論ではなく、そのまま編集して納品可能 |
| 要求分析スキル | 再利用可能な共通機能を集約：ドキュメント差分（Markdown／PDF／Excel／Word の物理比較）、管理対象成果物ツール（ハッシュ、Schema 検証、パス制限）、ソフトウェア設計ナレッジベース（初期化／チェック／索引／クエリ／時効）の3モジュールを他スキルへまるごとコピー可能 |
| 要求分析スキル | 自己完結型デプロイに変更：プロジェクトナレッジベース（要求ナレッジベースおよび HMI ソフトウェア設計ナレッジベース）、設定、スクリプト、契約をパッケージ同梱。Excel エクスポートは node ランタイムおよびネイティブバイナリに依存せず、クロスプラットフォームで利用可能 |
| 要求ドキュメント生成スキル | テキスト座標によるテーブル再構築機能を追加。信号定義テーブル、信号名テーブル、信号送受信情報テーブル、DID 定義テーブル、状態／動作説明テーブル、2つのビットエンコードテーブルをカバーし、結果に復元元を注記してレビュー可能 |
| 要求ドキュメント生成スキル | インクリメンタルデバッグ機能を追加：指定した要求 ID のみ再実行可能、および既存の Markdown と画像を保持したまま抽出を追記可能で、改稿時に PDF 全体を再実行する必要がありません |
| 要求ドキュメント生成スキル | 要求メタ情報の構造化出力を追加（バージョン、ページ範囲、ステータス、テーブル数と画像数、継続テーブル復元状況）。メタ情報は本文と分離し、旧形式ファイルも引き続き互換性あり |
| 構想調査ドキュメント | SSR 生成、要求分析、要求生成の3方向について「顧客のペインポイントと事業価値調査レポート」および「技術パスとリスク評価レポート」を追加。事業位置付け、現状のペインポイント、事業価値、ならびに実装プロセスの段階分解と導入リスク評価をカバー |
2.2 変更機能
| モジュール | 詳細 |
|---|---|
| 要求分析スキル | 位置付けを「要求変更分析」から「要求エンジニアリングワークフロー」にアップグレード：従来の5段階汎用変更分析から固定6段階パイプラインに変更。根拠取得を外部データベースおよびチケットシステムから、管理された入力とディスク保存済み証拠に変更し、トリガーワードと成果物構造もそれに合わせて調整 |
| 要求ドキュメント生成スキル | 章のコンテンツ帰属を再区分：共通属性章は静的定義テーブルのみ出力するよう縮小し、条件付き値ロジックと NVM 保存戦略は要求章に統一して帰属させ、同一内容の2箇所での重複や矛盾を回避 |
| 要求ドキュメント生成スキル | 2パス抽出方式を導入：車型使用パターン章と共通属性章について、まず原文に専用要求が存在するかを判定し、存在する場合は原文テーブルを直接切り出し、存在しない場合は行動要求の意味から帰納して推定と明示的に注記。原文テーブルが文字化けしている場合は行動要求から交差復元が可能 |
| 要求ドキュメント生成スキル | 欠落コンテンツの逆推論を廃止：原文に専用の故障処理要求がない場合、故障処理と故障復旧の2節は直接 N/A を記入。使用パターンで言及されていない列は既定の「No」から「N/A」に変更 |
| 要求ドキュメント生成スキル | 章認識ルールを精緻化：設定項目で「番号 + 全大文字設定名」表記の認識を追加、ポート章で命名対応関係とバスフィールド記入ルールを補足、要求章で項目開始フォーマットを統一し、要求間の相互参照は原文どおりに転記することを要求 |
| 要求ドキュメント生成スキル | Word ワイドテーブルのレイアウト最適化：列数に応じてフォントサイズを自動調整し、内容に基づいて列幅を計算してテーブルレイアウトを固定。列挙値と計測値はセル内改行分割をサポートし、取消線レンダリングをサポート |
| 要求ドキュメント生成スキル | 車型適用性マトリクスは1テーブルあたり最大8つの要求 ID 列とし、超過分は自動的に縦方向に複数テーブルへ分割 |
| 要求ドキュメント生成スキル | 実行時間を最適化：M1 コンテンツ体検査（ヘルスチェック）工程を廃止し、機能ごとに体検査サブタスクを並列ディスパッチして集計する処理をやめ、スクリプト実行とチェックリスト検証の2ステップに簡素化 |
| 要求ドキュメント生成スキル | スキル名から顧客名プレフィックスを除去し srd-generation に統一。トリガーワードは変更なし |
2.3 削除機能
| モジュール | 詳細 |
|---|---|
| 要求生成スキル | requirement-generation スキルを廃止。インテント受信、コンテキスト検索、分析集約、SRS レポート、要求ごとのパイプライン等の段階機能を一式削除し、当該スキルは利用不可 |
| 要求分析スキル | Neo4j／PostgreSQL データベースクエリおよび Jira／Redmine チケット追跡への依存を削除。物理差分は同梱の共通機能が担い、実行時に外部システムへ接続する必要がなくなりました |
| 要求ドキュメント生成スキル | M1 コンテンツ体検査工程とその集計成果物を削除。出力契約からも体検査レポートを削除 |
2.4 バグ修正
| モジュール | 詳細 |
|---|---|
| 要求分析スキル | ステージエンベロープ契約と成果物アセンブリの不整合により発生していた産出異常を修正 |
| 要求ドキュメント生成スキル | PDF テーブル認識失敗時に列ズレまたは切り詰めテーブルが出力される問題を修正し、テキスト座標によるテーブル再構築に変更 |
| 要求ドキュメント生成スキル | 生成した Word 文書でワイドテーブルがページ境界を超える問題を修正 |
| 要求ドキュメント生成スキル | ベクター画像とテーブル領域が重なった際にテーブル内容が誤って飲み込まれる問題を修正 |
| 要求ドキュメント生成スキル | 取消線付きの失効コンテンツが有効コンテンツとして抽出される問題を修正 |
v3.0.3
リリース日：2026-07-31 | ベースバージョン：v3.0.2
1. 概要
| 項目 | 内容 |
|---|---|
| リリース日 | 2026-07-31 |
| バージョン番号 | v3.0.3 |
| ベースバージョン | v3.0.2 |
2. 報告事項
本バージョンの主な内容は2つのワークフロー機能の実装です：機能安全 SSR 仕様書生成（ssr-generation） および SRD 生成（SRD-generation）。
2.1 新機能
2.1.1 機能安全 SSR 仕様書生成ワークフロー（ssr-generation）
SDS xlsx + 1〜複数の TSC xlsx を入力とし、機能安全 SSR 仕様書 Excel を出力します。トリガーワード：機能安全、SSR 仕様書生成。
| モジュール | 詳細 |
|---|---|
| ワークフローエンジン | 宣言型ワークフローエンジン：assets/{project}/workflow.json がステップ順序と成果物依存関係を宣言し、scripts/orchestrator.py がワークフロー解析、入力パラメータ解析（$entry.* / $<step>.<key>）、fan-outスケジューリングと成果物検証を担当します。メインエージェントはサブエージェントの fork とチェックリスト出力のみを行い、業務ロジックは実行しません |
| orchestratorスクリプト | resolve-inputs などのサブコマンドを提供し、@<utf8-json-file> ファイルパラメータ渡しと ASCII-safe JSON 出力をサポートし、Windows での中日文パスを含むコマンドラインエンコード問題を回避します |
| M1 ファイル解析（ssr-m1-file-parse） | エンジンが注入した会話添付パスのみを使用して SDS/TSC xlsx を解析し（ディレクトリの再帰検索は行わず）、要件ツリー、source manifest、USER_META、TSR情報、TSR階層、図要素、要素記述、SDS3.5、フィルタmanifest等の成果物を生成します |
| M2-1 タスク分割（ssr-m2-1-task-split） | DWG-first 分割戦略：各 (filter JSON, TSC object_TSR) 組合せに対して個別に filter_tree.py を呼び出し、複数の TSC をマージ処理することを禁止し、同じ DWG が複数の TSC に存在する場合は複数の独立したソースとして保持します。DWG 単位でタスクをグループ化して生成し、C ソース関数本体抽出（find_c_function / _extract_function_body / _extract_constant）と calib、ram_romsw、subsystem の3つのナレッジベースクエリを統合します |
| M2-2 タスク毎処理（ssr-m2-2-process-task） | fan_out モードで並列スケジューリング（max_concurrency=4）し、各サブエージェントは1つの DWG タスクのみを処理し、その DWG の SVG、*_r.json、funcbodies、TSR2参照を自ら読み取ってから思考し SSR ツリーを生成します。スクリプトによる一括ノード生成は明示的に禁止されています |
| M2-3 集約（ssr-m2-3-aggregate） | filter_source でグループ化し、各 element/source について1つの m2_viewpoint_*.json を出力します（merged_entries、ノードファイル参照、funcbodies参照と統計 meta を含む）。各 DWG のルート SSR とその branches[] サブツリーを保持し、同名の DWG が異なる TSC から来る場合はマージしません |
| M4 集計レポート（ssr-m4-summary-report） | ワークフローの終点：USER_META を読み取り system_name/system_id/model_name を取得し、固定 xlsx テンプレートを適用して ./outputs/FS-{system_id}-{model_name}-SSR-0000.xlsx を出力します。第4章ソフトウェア要件生成、TSR-SSR トレーサビリティマトリクス、要素挿入とシステムモジュール置換を含みます |
| エラーレポート | M4 は独立したエラーレポート FS-*-SSR-0000_error_report.xlsx を追加出力し、ノードファイル、関数未ヒットと変数ナレッジベースクエリ状態をトレースします |
| SSR 生成ルールとテンプレート | 階層生成ルール：親 SSR は簡潔な記述のみを含み、論理段落がある場合、最初の子 SSR は論理ブランチ記述でなければなりません。計算系 SSR 生成ルールを洗練させ、再帰制限を明確化しました。SSR テンプレート 4.1.1.XXXXX 番号形式、alloc を dwg に正規化（リアルなサブモジュール名がある場合は保持）、note フィールドに変数記述を補足 |
| 要素マージルール | TSR1 と異なる element の TSR2 は M1 で skip_ssr_generation=true とマークされ、TSR フィルタツリーにのみ保持され、DWG テーブルと M2-2 には入らず、代わりに類似項目の備考として反映されます |
| ナレッジベースクエリ | データベースヒット時に大文字小文字を無視し、C コードから取得した変数のみクエリ時にプレフィックスを削除します |
| フォールトトレランスフォールバック | M2-2 スケジューリング台帳により、タスクが実行中とマークされているが実際には未実行の状態を回避します。複数 manifest シナリオのフォールバック、タスク消失によるファイルタイムスタンプパスエラーのフォールバック戦略 |
| モジュールツリーデータソース（slwebview-html-extractor） | 付随する新規スキル：解凍済みの Simulink WebView/HTML エクスポートディレクトリから RequrimrntList.svg、*_h_*.json/*_s.json、*_r.json を読み取り、Eagle_Requirement リンクをフィルタし、Subsystem 以降の階層のみを保持し、source_folder でマージして modules_tree.json を出力し M2-1 で使用します |
2.1.2 SRD 生成ワークフロー（SRD-generation）
Geely SWRS PDF を構造化 SRD ドキュメント（Markdown + Word .docx）に変換します。トリガーワード：SWRS、SRD、要件ドキュメント生成、PDF分割、章再構築。パラメータ：--pdf <PDFパス> --function-list <機能リストExcelパス> [--workspace <プロジェクトディレクトリ>]。
| モジュール | 詳細 |
|---|---|
| ワークフローエンジン | 同じく宣言型ワークフローエンジン：assets/workflow.json が M0→M1→M2→M3 の4ステップ順序と成果物依存関係を宣言し、エンジンはスケジューリングのみを行い業務ロジックは実行せず、各ステップは fork した独立したサブエージェントで完了します |
| M0 PDF分割（srd-m0-pdf-split） | SWRS PDF を要件ID単位で独立した Markdown ファイルに分割し、構造化処理（段落ラベルの見出しへの変換、論理ブロックのフォーマット）を行います。run_m0.py が分割と構造化の2段階を一体化し、--workers マルチプロセスをサポートします。また inspect_pdf_pages.py をページトラブルシューティング用に提供します |
| M1 機能別抽出（srd-m1-extract） | 機能リスト Excel と M0 出力を読み取り、（要件ドキュメント、一次機能、二次機能）でグループ化し、各機能について1つの JSON と総manifestを出力します。オプションで SWRT Excel を読み取り車型適用性を取得し、ユーザー入力から車型設定列（例：W,X,G）の識別をサポートします |
| M2 章再構築（srd-m2-restructure） | 各機能にサブエージェントを派遣し、9サブセクションテンプレートで要件内容を再構築した後、完全な SRD Markdown に組み立てます。マルチエージェント並列サブセクション処理と画像認識挿入をサポートします |
| M2 章テンプレート | サブセクション1 Overview And Project、サブセクション2 VMM Requirement（CM/UM制約テーブル）、サブセクション3 Configuration、サブセクション4 Ports（外部バス信号と物理属性）、サブセクション5 Internal Variable and DIDs、サブセクション6 Public Attribute、サブセクション7 Requirement（原文構造をできるだけ保持）、サブセクション8/9 Fault Handling & Fault Recovery、他に品質要件と要件トレーサビリティ、書き込み前チェックリストを含みます |
| M2 外部データクエリ | preload_databases.py が CCDB とシグナルマトリクス Excel を JSON キャッシュとしてプリロードし、各サブエージェントの重複解析を回避します。サブエージェントは query_ccdb.py、query_signal_matrix.py でシグナル物理属性と設定パラメータをクエリします |
| M3 Word生成（srd-m3-docx） | M2 が出力した SRD Markdown を .docx に変換し、style_standard.json 標準スタイル、目次フィールドとフォーマット済みテーブルを適用します |
2.2 変更機能
| モジュール | 詳細 |
|---|---|
| なし | なし |
2.3 削除機能
| モジュール | 詳細 |
|---|---|
| なし | なし |
2.4 バグ修正
| モジュール | 詳細 |
|---|---|
| なし | なし |
v3.0.2
リリース日：2026-07-07 | ベースバージョン：v3.0.1
2.1 新機能
| モジュール | 詳細 |
|---|---|
| 差分ツールsubagent | 差分ツールsubagentを追加 |
2.2 変更機能
| モジュール | 詳細 |
|---|---|
| なし | なし |
2.3 削除機能
| モジュール | 詳細 |
|---|---|
| なし | なし |
2.4 バグ修正
| モジュール | 詳細 |
|---|---|
| なし | なし |
v3.0.1
リリース日：2026-05-22 | ベースバージョン：v3.0.0
2.1 新機能
| モジュール | 詳細 |
|---|---|
| - | - |
2.2 変更機能
| モジュール | 詳細 |
|---|---|
| 要求分析スキル | 要求分析スキルを汎用スキルに変更 |
2.3 削除機能
| モジュール | 詳細 |
|---|---|
| なし | なし |
2.4 バグ修正
| モジュール | 詳細 |
|---|---|
| なし | なし |