Communityコーディング&開発github.com

jumibot/informe_deliberativa

Software Factoryの審議タスク(調査、審議、設計)の報告書を作成または更新します。要約、分析、決定事項、未決定事項、分離提案、派生タスクを固定構造で管理し、質問は選択肢付きカード、推奨事項、ステータス(未決定、決定、分離)で表示。各更新でバージョンアップ、旧版を_respaldo/にバックアップ、HTMLを再生成します。

informe_deliberativa とは?

このスキルは、Software Factory(SF)における審議タスク(調査、審議、設計)の報告書を作成・更新するためのエージェントスキルです。報告書は、要約、分析、決定事項、未決定事項(選択肢付き質問カード)、分離提案(他のタスクへの移行案)、派生タスクのセクションで構成されます。各質問には推奨オプションとステータス(未決定、決定、分離)が設定され、オーナーの回答に応じて動的に更新されます。このスキルは、SFのドキュメント生成基盤`crear_documentos`を利用し、報告書のテンプレート、バージョン管理、HTML再生成を自動化します。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェントで、SFの規約(決定事項231、217、220など)に準拠した構造化ドキュメントを生成します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jumibot/SoftwareFactory/tree/main/plugins/sf/skills/informe_deliberativa

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

審議報告書

審議タスク(調査、審議、設計。「タスクの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}とともに配置されます。これにより、オーナーがどこを見ればよいかがわかり、タスクがリンクできるようになります。

  1. 要約 {#resumen}。結論を2~3段落で簡潔に:提案内容、その根拠、未解決の質問の数と場所。全体像を明確にする図がある場合はここに配置。最後に、決定すべき事項へのリンクで締めくくります([N個の質問を見る](#por-decidir){: .salto})。
  2. 分析。1つ以上の独自セクションで:調査内容と提案内容、およびその理由。最初に提案または結論を提示し、その後にそれを支える評価と限界を記載。ここでテーマに関するカード、図、表を配置します。
  3. 決定済み {#decidido}。このタスクで確定したオーナーの決定を一覧にした表:番号 | 決定内容 | ここで確定する事項。各決定は、ここに表示される前に、それぞれの決定ファイルに記録されています。
  4. 未決定 {#por-decidir}。未解決の質問を ::: preguntas ブロックにまとめます。質問が多い場合は、重要度や分離先に応じて、それぞれセクション({#por-decidir-<行き先>})に分割します。各ブロックは、その内容を説明する文と、分離セクションへのリンクで始まります。
  5. 分離 {#separar}。提案された分離:分離ごとにカード({: #a-<行き先>})を作成し、移行するもの(質問、各質問へのリンク付き)と行き先(新しいタスク、既存タスクのステップ、または /sf_split)を記載します。分離方法を選択する必要がある場合も、質問として扱います。
  6. タスク {#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サイクルを実行します:

  1. バックアップ 置き換えるバージョン:python -I -X utf8 <skills>/crear_documentos/scripts/respaldar.py <report>.md <reason>(「ドキュメントを置き換える前に、_respaldo/にバックアップする」、217)。

  2. 変更を記述:回答済み質問のステータス、「決定済み」、分離、タスク、要約を更新。バージョンアップ ヘッダー内のバージョンを上げ(2.5 → 2.6;最初の数字は報告書の構造変更時に変更)、estado を更新。

  3. HTMLを再生成 同じ変更内で(「.md の変更ごとに HTML を再生成する」、220):

    python -I -X utf8 <skills>/informe_deliberativa/scripts/informe_to_html.py <report>.md
    
  4. develop に送信 ブランチを作成せずに。新しいドキュメントのため(「新しいドキュメントは各サイクルで develop に送られ、ブラウザで提供される」、216)。該当コマンドが存在する場合はそれを使用(「新しいドキュメントは各サイクルで develop に送り、ブラウザで開く」、297)。

  5. HTML をブラウザで開く提案 新しいバージョンで。

チェック

crear_documentos のチェック(「チェック」)に加えて、以下を確認:

  • 各未解決質問には少なくとも2つの選択肢と1つの推奨がある。決定済み質問に elegida がない、または分離済み質問に destino がない場合はエラー。
  • 要約の数値(未解決質問数、分離数、タスク数)が各セクションの内容と一致する。
  • 各質問(#pN)または分離(#a-…)へのリンクが有効である。
  • 「決定済み」の表には、既に登録された決定のみが記載されている。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

jumibot/documento_fundacional

Crea o revisa el documento fundacional de un proyecto o de un producto — su presentación formal, más formal que el documento de visión y sin historia conductora — con la necesidad documentada, la tesis de desarrollo, qué es el producto, los escenarios de uso, las evidencias con lo que respaldan y lo que no, qué debe demostrar el piloto y las fuentes. Para el autor y para compartir con colaboradores, socios o financiadores. Úsala cuando pidan un documento fundacional, una presentación o justificación formal del proyecto, un manifiesto, un dossier o un caso de desarrollo, o convertir uno existente (PDF, HTML) a este formato. Genera .md → .html con el generador y los recursos comunes de crear_documentos (portada sobria, secciones plegables, tarjetas, fichas con buscador, referencias) y el tema de la identidad del proyecto; se imprime en A4.

jumibot/flujo_tareas

Ciclo de vida de las tareas de un proyecto bajo la Software Factory (SF) y su cola, .sf/peticiones.json — estados (en cola, en curso, en observación, descartada), pasos, ramas feature/NN-nombre, subagentes, prueba y cierre por squash en develop, descarte, reversión, reapertura, eliminación, fusión y separación, historial por tarea y copias de la cola — con el CLI tools/cola.py. Úsala siempre que haya que tocar la cola — anotar una petición o un bug, poner una tarea en curso o dejarla en cola, crear su rama, añadir o marcar pasos, lanzar o recoger un subagente, dejarla lista para probar, cerrarla, pasarla a observación o devolverla a ella, cerrarla o revertirla en observación, descartarla, reabrirla, eliminarla, fusionar o separar tareas, o recuperar una cola rota.

関連スキル