jumibot/informe_deliberativa

의사결정 보고서

의사결정 과제(조사, 숙의 또는 설계; 「세 가지 유형의 과제, 세 가지家族」, 223)는 보고서와 그로부터 도출된 과제를 제공합니다(「의사결정 과제는 보고서와 그로부터 도출된 과제를 제공한다」, 218). 과제의 딜레마는 보고서 내에 존재하며, 소유자의 각 응답에 따라 최신 상태로 유지되며, 큐(queue)나 다른 파일에 저장되지 않습니다. 다른 과제에 속하는 내용은 분리가 제안됩니다. 과제 종료 시, 여전히 열려 있는 내용은 해당 과제로 이동합니다(「의사결정 과제에서, 다른 과제에 속하는 내용은 분리가 제안된다」, 221). 의사결정 과제는 아무것도 테스트하지 않고 보고서만 변경합니다. 적용해야 할 사항은 과제가 생성하는 작업들이 수행합니다.

이 스킬은 보고서에 포함되어야 할 내용, 질문 작성 방법, 각 회차의 진행 방식을 설명합니다. 생성기, 리소스, 주제 및 검증은 crear_documentos의 것을 따르며, 이 문서와 함께 읽어야 합니다. 의사결정 계열 에이전트가 존재할 때까지는 과제의 하위 에이전트가 이 스킬을 로드합니다(「전문 에이전트, 각 과제 유형별 하나」, 304).

독자는 결정을 내려야 하는 소유자입니다. 보고서는 소유자의 작업을 줄여줍니다: 결정해야 할 사항이 먼저 표시되고, 각 질문은 문자로 답변되며, 추천 사항은 한눈에 알아볼 수 있습니다. 효과적인 의사소통은 SF의 목표 중 하나입니다(결정 231).

위치

• SF에 통합된 프로젝트의 경우, sf/informes/ 디렉토리(「SF 문서는 sf/ 폴더에 위치한다」, 203).
• SF 자체의 경우, docs/referencias/reports/ 디렉토리, sf/로 이동하는 것이 결정될 때까지(과제 303의 「과제 유형」 보고서, 질문 13).

파일 이름은 과제 번호가 아닌 주제입니다: 과제 유형.md 및 해당 .html. 대체된 버전은 동일한 폴더의 _respaldo/로 이동합니다.

모델: SF의 docs/referencias/reports/과제 유형.md 보고서(과제 274). 팀에 있다면 예시로 읽을 수 있으며, 그 내용은 복사되지 않습니다. 빈 템플릿은 assets/plantilla-informe.md에 있습니다.

구조

섹션은 항상 다음 순서를 따르며, {#id}를 사용하여 소유자가 찾아보고 과제가 연결할 수 있도록 합니다:

1. 요약 {#resumen}. 두세 개의 짧은 단락으로 결론: 무엇이 제안되었는지, 어떤 근거에 기반하는지, 남은 질문의 수와 위치. 전체를 설명하는 개요가 있다면 여기에 포함됩니다. 결정해야 할 사항으로 이동하는 링크로 끝납니다([N개 질문 보기](#por-decidir){: .salto}).
2. 분석, 하나 이상의 자체 섹션: 연구된 내용과 제안된 내용, 그 이유. 나머지 내용에서 파생되더라도 먼저 제안 또는 결론을 제시하고, 이를 뒷받침하는 평가와 한계를 제시합니다. 주제와 관련된 카드, 개요 및 테이블이 여기에 위치합니다.
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이 가장 중요). 번호와 앵커 {: #pN}는 질문이 결정되거나 분리되어도 변경되지 않습니다: 과제의 단계는 이를 통해 인용합니다(「…를 결정 (질문 5) (보고서 「과제 유형」, 274)」).
• 한두 문장의 맥락, 선택에 필요한 경우에만: 현재 상황 또는 결정이 필요한 이유.
• 두세 개의 옵션, 옵션 A, 옵션 B…, 각각은 한두 문장으로 그 의미를 설명. 「현재와 같이」는 실제로 옵션인 경우에만 옵션으로 제시됩니다.
• 추천 및 그 이유를 한 문장으로, 제목에 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 <informe>.md <motivo> (「문서를 대체하기 전에 _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 <informe>.md
   

4. 새 문서이므로 브랜치 없이 develop으로 전송(「새 문서는 각 회차마다 develop으로 전송되고 브라우저에서 제공된다」, 216), 해당 명령이 존재할 때 사용(「새 문서는 각 회차마다 develop으로 전송되고 브라우저에서 열린다」, 297).

5. 새 버전의 HTML을 브라우저에서 열도록 제안.

검증

crear_documentos의 검증(「검증」)과 추가로:

• 각 열린 질문은 최소 두 개의 옵션과 하나의 추천 옵션이 있어야 함; 결정된 질문은 elegida 없이, 분리된 질문은 destino 없이 있어서는 안 됨;
• 요약의 개수(열린 질문, 분리, 과제)가 섹션과 일치해야 함;
• 질문(#pN) 또는 분리(#a-…)에 대한 각 링크가 존재해야 함;
• 「결정됨」 테이블에는 이미 등록된 결정만 포함되어야 함.