Weekly Report GXP
Generate developer weekly reports with member attribution. Prefer the deterministic scripts in scripts/ and keep the report grounded in local project data.
Workflow
- Confirm or infer report period. Default to current Monday through Sunday.
- Resolve target members. If the user specifies names, filter output to those members. If not, generate a team report.
- Collect sources:
- Git commits with
scripts/collect_git.py. - Todo/issue files with
scripts/parse_tasks.py. - Meeting notes with
scripts/parse_meetings.py. - Manual content with
scripts/parse_user_content.py.
- Git commits with
- Aggregate with
scripts/aggregate_report_data.py. - Render HTML with
scripts/render_report.pyusingassets/styles.css.
Inputs
members.json: maps real member names to git authors, emails, short names, and mention aliases.todo.md,TODO.md,issues.md,ISSUES.md, ortasks.json: task status and owners.meeting-notes.mdormeetings/*.md: meeting attendees, decisions, risks, and action items.problems.md/json,growth.md/json,knowledge.md/json,risks.md/json,next-plans.md/json, oruser-input.json: manual report content.
Read references/input-formats.md when creating or debugging input files. Read references/data-schema.md before changing aggregation or rendering. Read references/report-sections.md before changing report layout.
Output
Write generated files under a user-specified output directory, or weekly-report-output/ by default:
report-data.jsonweekly-report-<member-or-team>-<end-date>.html
Notes
- If the target project is not a git repository, continue with tasks, meetings, and manual content.
- Do not invent accomplishments. Use empty-state text when a section has no data.
- Preserve the user's Chinese names and wording in report content.
- This skill outputs HTML only.