審議報告書
審議タスク(調査、審議、設計。「タスクの7種類と3つのファミリー」、223)は、報告書とそこから派生するタスクを生成します(「審議タスクは報告書と派生タスクを生成する」、218)。そのジレンマは報告書内に存在し、オーナーの各回答に応じて更新され、キューや他のファイルには置かれません。他のタスクに属するものは分離を提案します。クローズ時には、未解決のものはそのタスクに引き継がれます(「審議タスクでは、他のタスクに属するものは分離を提案する」、221)。審議タスクは何もテストせず、報告書のみを変更します。適用すべき内容は、生成されたタスクが実行します。
このスキルは、報告書の構成、質問の書き方、各更新サイクルを定義します。ジェネレーター、リソース、テーマ、チェックはcrear_documentosのものを使用し、こちらと併せて参照してください。これは、審議タスクファミリーのエージェントスキルです(「専門エージェント、タスクファミリーごとに1つ」、304)。現時点では、タスクのサブエージェントがこれを読み込みます。
読者はオーナーであり、意思決定を行う必要があります。 報告書はオーナーの作業を軽減します。決定すべきことが最初に表示され、各質問は文字選択で回答でき、推奨事項が一目でわかります。適切なコミュニケーションはSFの目標です(決定事項231)。
配置場所
- SFに組み込まれたプロジェクトでは、
sf/informes/(「SFのドキュメントはsf/フォルダに配置される」、203)。 - SF自体では、
sf/への移行が決定されるまで、docs/referencias/reports/(タスク303の「タスクの種類」報告書、質問13)。
ファイル名はタスク番号ではなくテーマです。例:Tipos de tarea.md とその .html。置き換えられたバージョンは同じフォルダ内の_respaldo/に移動されます。
モデル: SFの報告書 docs/referencias/reports/Tipos de tarea.md(タスク274)。チーム内にある場合は例として参照しますが、内容をコピーすることはありません。空のテンプレートは assets/plantilla-informe.md にあります。
構成
セクションは常に以下の順序で、指定された{#id}とともに配置されます。これにより、オーナーがどこを見ればよいかがわかり、タスクがリンクできるようになります。
- 要約
{#resumen}。結論を2~3段落で簡潔に:提案内容、その根拠、未解決の質問の数と場所。全体像を明確にする図がある場合はここに配置。最後に、決定すべき事項へのリンクで締めくくります([N個の質問を見る](#por-decidir){: .salto})。 - 分析。1つ以上の独自セクションで:調査内容と提案内容、およびその理由。最初に提案または結論を提示し、その後にそれを支える評価と限界を記載。ここでテーマに関するカード、図、表を配置します。
- 決定済み
{#decidido}。このタスクで確定したオーナーの決定を一覧にした表:番号 | 決定内容 | ここで確定する事項。各決定は、ここに表示される前に、それぞれの決定ファイルに記録されています。 - 未決定
{#por-decidir}。未解決の質問を::: preguntasブロックにまとめます。質問が多い場合は、重要度や分離先に応じて、それぞれセクション({#por-decidir-<行き先>})に分割します。各ブロックは、その内容を説明する文と、分離セクションへのリンクで始まります。 - 分離
{#separar}。提案された分離:分離ごとにカード({: #a-<行き先>})を作成し、移行するもの(質問、各質問へのリンク付き)と行き先(新しいタスク、既存タスクのステップ、または/sf_split)を記載します。分離方法を選択する必要がある場合も、質問として扱います。 - タスク
{#tareas}。派生するタスク:タスク | タイプ | 役割。既に存在するタスクは番号付きで表示。
付録は、必要な場合のみ最後に配置:ソース(::: fuentes)、完全なデータ、別のタスクで変更されるドキュメントの提案テキスト。
分析によって未決定、分離、作成事項が何も生じない場合、該当セクションは削除します。他のセクションの順序は変更しません。
ヘッダー: antetitulo に「プロジェクト · <分析、設計、調査>報告書 · <月 年>」、lema、subtitulo に報告書が回答する内容、version、estado(「提案 · タスクN」、「決定済み · タスクN」…)、portada: oscura、destino: proyecto、herramientas、menu: secciones(オーナーがセクション間を移動)、tipo(「分析報告書」、「設計報告書」、「調査報告書」)、pie にタスク、報告書の由来、決定者を記載。
質問について
各質問は ::: preguntas のカードであり、crear_documentos のリソース「選択肢付き質問」を使用します:
::: preguntas 2 plegables
### 1 · 「自分のドキュメントのみ」をどう守るか {recomendada=A} {: #p1}
現在は監視がありません。任意のステップがタスク内に入り込めます。
選択肢A
: タスクがコマンドで自分のドキュメントを宣言し、`cerrar` はブランチが他のファイルに触れている場合は拒否する。
選択肢B
: オーケストレーションにルールを記述するのみ。
推奨
: **A.** プリンシパルの記憶ではなく、コマンドで実現する。
:::
- 質問ごとに1つの意思決定。重要度順に番号付きのタイトル(1が最も重要)。番号とアンカー
{: #pN}は、質問が決定または分離されても変更されません。タスクのステップはこれらを使用して引用します(「決定 …(質問5)(「タスクの種類」報告書、274)」)。 - コンテキストは1~2文で、選択に必要な場合のみ記載:現状や決定が必要な理由。
- 2つまたは3つの選択肢、
選択肢A、選択肢B…。各選択肢は1~2文でその意味を説明。現状維持が真に選択肢となる場合に限り、「現状通り」を選択肢として含めます。 - 推奨事項とその理由を1文で記載。タイトルに
recomendada=Aと含めることで強調表示。未解決の質問にはすべて推奨事項が必要です。ジェネレーターは不足を警告します。 - ステータス。各回答に応じて更新:
estado=abierta(デフォルト):回答待ち。estado=decidida elegida=B:Decisiónフィールドに選択内容とそのニュアンス、登録された決定番号を記載。選択されたオプションがマークされ、その他はグレー表示。estado=separada destino=tarea_303:別のタスクに移動(_はマーク内でスペースとして読み替えられます)。移動先タスクがリンクできるよう、報告書内に残ります。
- 他の質問に依存する質問は、コンテキスト内でその旨を記載し、相手の質問にリンクします。
質問が決定または分離された場合、そのカードは新しいステータスでブロック内に残り、決定は「決定済み」の表にも追加されます。要約には、未解決の質問の数が記載されます。
各更新サイクル
オーナーの各回答、または報告書を変更する分析の進展ごとに、以下の1サイクルを実行します:
-
バックアップ 置き換えるバージョン:
python -I -X utf8 <skills>/crear_documentos/scripts/respaldar.py <report>.md <reason>(「ドキュメントを置き換える前に、_respaldo/にバックアップする」、217)。 -
変更を記述:回答済み質問のステータス、「決定済み」、分離、タスク、要約を更新。バージョンアップ ヘッダー内のバージョンを上げ(2.5 → 2.6;最初の数字は報告書の構造変更時に変更)、
estadoを更新。 -
HTMLを再生成 同じ変更内で(「.md の変更ごとに HTML を再生成する」、220):
python -I -X utf8 <skills>/informe_deliberativa/scripts/informe_to_html.py <report>.md -
developに送信 ブランチを作成せずに。新しいドキュメントのため(「新しいドキュメントは各サイクルで develop に送られ、ブラウザで提供される」、216)。該当コマンドが存在する場合はそれを使用(「新しいドキュメントは各サイクルで develop に送り、ブラウザで開く」、297)。 -
HTML をブラウザで開く提案 新しいバージョンで。
チェック
crear_documentos のチェック(「チェック」)に加えて、以下を確認:
- 各未解決質問には少なくとも2つの選択肢と1つの推奨がある。決定済み質問に
elegidaがない、または分離済み質問にdestinoがない場合はエラー。 - 要約の数値(未解決質問数、分離数、タスク数)が各セクションの内容と一致する。
- 各質問(
#pN)または分離(#a-…)へのリンクが有効である。 - 「決定済み」の表には、既に登録された決定のみが記載されている。