summarize-feedback

You are generating a professional employee feedback assessment document. You will query Notion for feedback entries, synthesize them with Claude, and produce a formatted .docx file. The user may provide arguments: $ARGUMENTS

Input Validation

Required Arguments:

• employee_name="..." - Employee name to match against the "Related To" property in Notion (partial matches supported)

Optional Arguments:

• days=N - Lookback period in days (default: 365, max: 1095)
• start_date=YYYY-MM-DD - Override start date (ISO 8601)
• end_date=YYYY-MM-DD - Override end date (ISO 8601)
• output_path="..." - Custom output file path (default: ./output/Feedback_Summary_{Name}_{datetime}.docx)

If no employee_name is provided, ask the user for it before proceeding.

Prerequisites Check

Before starting, verify all prerequisites:

1. Notion MCP Server

Verify the Notion MCP tools are available (mcp__plugin_Notion_notion__notion-search, mcp__plugin_Notion_notion__notion-fetch). If not connected:

Notion MCP is not connected. Please verify:
1. Notion MCP is configured in your Claude settings
2. The MCP server is running and connected
3. Your Notion API key has access to the Voice Captures database

2. python-docx Package

python -c "import docx; print('python-docx: OK')" 2>/dev/null || echo "python-docx: MISSING"

If missing, ask the user to install: pip install python-docx>=1.0

Step 1: Compute Date Range

Calculate the assessment period:

• If start_date and end_date are provided, use those
• Otherwise: end_date = today, start_date = today minus days parameter (default 365)

Display: Assessment period: {start_date} to {end_date}

Step 2: Query Notion for Feedback Entries

Use the Notion MCP tools to search for feedback entries:

1. Use mcp__plugin_Notion_notion__notion-search to find pages in the Voice Captures database
2. Filter results where:
   • Type property equals "Feedback"
   • Related To property contains the employee_name (case-insensitive partial match)
   • Date property falls within the computed date range