@codihaus/claude-skills 1.0.0

package/skills/debrief/scripts/generate_questionnaire.py

@@ -0,0 +1,195 @@
+#!/usr/bin/env python3
+"""
+Generate dynamic questionnaire based on debrief gaps.
+Called at end of debrief with identified open questions.
+
+Usage:
+    python generate_questionnaire.py output.xlsx questions.json
+
+questions.json format:
+{
+    "project_name": "Project Name",
+    "date": "2024-01-20",
+    "questions": [
+        {
+            "category": "Requirements",
+            "question": "What is the expected user load?",
+            "priority": "Required",
+            "context": "Needed for infrastructure planning",
+            "source": "UC-PAY-003"
+        }
+    ]
+}
+"""
+
+import sys
+import json
+from openpyxl import Workbook
+from openpyxl.styles import Font, PatternFill, Alignment, Border, Side
+from openpyxl.utils import get_column_letter
+
+
+def create_questionnaire(output_path: str, questions_data: dict):
+    wb = Workbook()
+    ws = wb.active
+    ws.title = "Questions"
+
+    # Styles
+    header_font = Font(bold=True, color="FFFFFF", size=12)
+    header_fill = PatternFill("solid", fgColor="4472C4")
+    required_fill = PatternFill("solid", fgColor="FCE4D6")
+    optional_fill = PatternFill("solid", fgColor="E2EFDA")
+    border = Border(
+        left=Side(style='thin'),
+        right=Side(style='thin'),
+        top=Side(style='thin'),
+        bottom=Side(style='thin')
+    )
+    wrap_alignment = Alignment(wrap_text=True, vertical='top')
+
+    # Title row
+    ws.merge_cells('A1:E1')
+    title_cell = ws['A1']
+    title_cell.value = f"Questions for: {questions_data.get('project_name', 'Project')}"
+    title_cell.font = Font(bold=True, size=14)
+    title_cell.alignment = Alignment(horizontal='center')
+
+    # Date row
+    ws.merge_cells('A2:E2')
+    ws['A2'] = f"Generated: {questions_data.get('date', '')}"
+    ws['A2'].font = Font(italic=True, color="666666")
+    ws['A2'].alignment = Alignment(horizontal='center')
+
+    # Headers
+    headers = ["Category", "Question", "Priority", "Answer", "Context/Source"]
+    col_widths = [15, 45, 12, 40, 25]
+
+    for col, (header, width) in enumerate(zip(headers, col_widths), 1):
+        cell = ws.cell(row=4, column=col, value=header)
+        cell.font = header_font
+        cell.fill = header_fill
+        cell.alignment = Alignment(horizontal='center', vertical='center')
+        cell.border = border
+        ws.column_dimensions[get_column_letter(col)].width = width
+
+    # Questions
+    questions = questions_data.get('questions', [])
+
+    for row_idx, q in enumerate(questions, 5):
+        category = q.get('category', 'General')
+        question = q.get('question', '')
+        priority = q.get('priority', 'Optional')
+        context = q.get('context', '')
+        source = q.get('source', '')
+
+        # Combine context and source
+        context_text = context
+        if source:
+            context_text = f"{context}\n[Source: {source}]" if context else f"[Source: {source}]"
+
+        ws.cell(row=row_idx, column=1, value=category).border = border
+
+        q_cell = ws.cell(row=row_idx, column=2, value=question)
+        q_cell.border = border
+        q_cell.alignment = wrap_alignment
+
+        priority_cell = ws.cell(row=row_idx, column=3, value=priority)
+        priority_cell.border = border
+        priority_cell.alignment = Alignment(horizontal='center')
+        if priority == "Required":
+            priority_cell.fill = required_fill
+        else:
+            priority_cell.fill = optional_fill
+
+        ws.cell(row=row_idx, column=4, value="").border = border
+
+        ctx_cell = ws.cell(row=row_idx, column=5, value=context_text)
+        ctx_cell.border = border
+        ctx_cell.alignment = wrap_alignment
+        ctx_cell.font = Font(italic=True, color="666666", size=10)
+
+    # Set row heights
+    ws.row_dimensions[1].height = 25
+    ws.row_dimensions[4].height = 25
+    for row in range(5, len(questions) + 5):
+        ws.row_dimensions[row].height = 35
+
+    # Freeze header row
+    ws.freeze_panes = 'A5'
+
+    # Summary sheet
+    ws_summary = wb.create_sheet("Summary", 0)
+    summary_data = [
+        ("Project Questionnaire", ""),
+        ("", ""),
+        ("Project:", questions_data.get('project_name', '')),
+        ("Generated:", questions_data.get('date', '')),
+        ("Total Questions:", len(questions)),
+        ("", ""),
+        ("Priority Breakdown:", ""),
+    ]
+
+    # Count priorities
+    required_count = sum(1 for q in questions if q.get('priority') == 'Required')
+    optional_count = len(questions) - required_count
+
+    summary_data.extend([
+        ("Required:", required_count),
+        ("Optional:", optional_count),
+        ("", ""),
+        ("Categories:", ""),
+    ])
+
+    # Count categories
+    categories = {}
+    for q in questions:
+        cat = q.get('category', 'General')
+        categories[cat] = categories.get(cat, 0) + 1
+
+    for cat, count in sorted(categories.items()):
+        summary_data.append((f"  {cat}:", count))
+
+    summary_data.extend([
+        ("", ""),
+        ("Instructions:", ""),
+        ("1.", "Fill in the 'Answer' column for each question"),
+        ("2.", "Required questions must be answered before proceeding"),
+        ("3.", "Context/Source shows where this question originated"),
+        ("4.", "Save and return this file when complete"),
+    ])
+
+    for row, (col1, col2) in enumerate(summary_data, 1):
+        ws_summary.cell(row=row, column=1, value=col1)
+        ws_summary.cell(row=row, column=2, value=col2)
+        if row == 1:
+            ws_summary.cell(row=row, column=1).font = Font(bold=True, size=14)
+        elif col1.endswith(':') and col2 != "":
+            ws_summary.cell(row=row, column=1).font = Font(bold=True)
+
+    ws_summary.column_dimensions['A'].width = 25
+    ws_summary.column_dimensions['B'].width = 40
+
+    # Save
+    wb.save(output_path)
+    print(f"Created: {output_path}")
+    print(f"  - {len(questions)} questions")
+    print(f"  - {required_count} required, {optional_count} optional")
+    return output_path
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 3:
+        print("Usage: python generate_questionnaire.py output.xlsx questions.json")
+        print("\nOr pipe JSON: echo '{...}' | python generate_questionnaire.py output.xlsx -")
+        sys.exit(1)
+
+    output = sys.argv[1]
+    json_source = sys.argv[2]
+
+    if json_source == "-":
+        data = json.load(sys.stdin)
+    else:
+        with open(json_source, 'r') as f:
+            data = json.load(f)
+
+    create_questionnaire(output, data)