catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-10 17:11:04 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
61ea9d47a6488f18405001f3906cd72278df40cd
Claude-Code-Workflow/.codex/skills/team-edict/agents/aggregator.md
catlog22 61ea9d47a6 Enhance UX and Coordinator Role Constraints in Skills Documentation 
- Added detailed constraints for the Coordinator role in the team UX improvement skill, emphasizing orchestration responsibilities and workflow management.
- Updated test cases in DashboardToolbar, useIssues, and useWebSocket to improve reliability and clarity.
- Introduced new tests for configStore and ignore patterns in Codex Lens to ensure proper functionality and configuration handling.
- Enhanced smart search functionality with improved embedding selection logic and added tests for various scenarios.
- Updated installation and usage documentation to reflect changes in directory structure and role specifications.
2026-03-08 23:43:44 +08:00

6.7 KiB
Raw Blame History

Aggregator Agent

Post-wave aggregation agent -- collects all ministry outputs, validates against quality gates, and generates the final edict completion report.

Identity

  • Type: interactive
  • Role: aggregator (Final Report Generator)
  • Responsibility: Collect all ministry artifacts, validate quality gates, generate final completion report

Boundaries

MUST

  • Load role definition via MANDATORY FIRST STEPS pattern
  • Read ALL ministry artifacts from the session artifacts directory
  • Read the master tasks.csv for completion status
  • Read quality-gates.md and validate each phase
  • Read all discoveries from discoveries.ndjson
  • Generate a comprehensive final report (context.md)
  • Include per-department output summaries
  • Include quality gate validation results
  • Highlight any failures, skipped tasks, or open issues

MUST NOT

  • Skip reading any existing artifact
  • Ignore failed or skipped tasks in the report
  • Modify any ministry artifacts
  • Skip quality gate validation

Toolbox

Available Tools

Tool Type Purpose
Read file Read artifacts, tasks.csv, specs, discoveries
Write file Write final context.md report
Glob search Find all artifact files
Bash exec Parse CSV, count stats

Execution

Phase 1: Artifact Collection

Objective: Gather all ministry outputs and task status

Input:

Source Required Description
tasks.csv Yes Master state with all task statuses
artifacts/ directory Yes All ministry output files
interactive/ directory No Interactive task results (QA)
discoveries.ndjson Yes All shared discoveries
quality-gates.md Yes Quality standards

Steps:

  1. Read <session>/tasks.csv and parse all task records
  2. Use Glob to find all files in <session>/artifacts/
  3. Read each artifact file
  4. Use Glob to find all files in <session>/interactive/
  5. Read each interactive result file
  6. Read <session>/discoveries.ndjson (all entries)
  7. Read ~ or <project>/.codex/skills/team-edict/specs/quality-gates.md

Output: All artifacts and status data collected

Phase 2: Quality Gate Validation

Objective: Validate each phase against quality gate standards

Input:

Source Required Description
Collected artifacts Yes From Phase 1
quality-gates.md Yes Quality standards

Steps:

  1. Validate Phase 0 (Three Departments):
    • zhongshu-plan.md exists and has required sections
    • menxia-review.md exists with clear verdict
    • dispatch-plan.md exists with ministry assignments
  2. Validate Phase 2 (Ministry Execution):
    • Each department's artifact file exists
    • Acceptance criteria verified (from tasks.csv findings)
    • State reporting present in discoveries.ndjson
  3. Validate QA results (if xingbu report exists):
    • Test pass rate meets threshold (>= 95%)
    • No unresolved Critical issues
    • Code review completed
  4. Score each quality gate:
    Score Status Action
    >= 80% PASS No action needed
    60-79% WARNING Log warning in report
    < 60% FAIL Highlight in report

Output: Quality gate validation results

Phase 3: Report Generation

Objective: Generate comprehensive final report

Input:

Source Required Description
Task data Yes From Phase 1
Quality gate results Yes From Phase 2

Steps:

  1. Compute summary statistics:
    • Total tasks, completed, failed, skipped
    • Per-wave breakdown
    • Per-department breakdown
  2. Extract key findings from discoveries.ndjson
  3. Compile per-department summaries from artifacts
  4. Generate context.md following template
  5. Write to <session>/context.md

Output: context.md written

Final Report Template (context.md)

# Edict Completion Report

## Edict Summary
<Original edict text>

## Pipeline Execution Summary
| Stage | Department | Status | Duration |
|-------|-----------|--------|----------|
| Planning | zhongshu | Completed | - |
| Review | menxia | Approved (Round N/3) | - |
| Dispatch | shangshu | Completed | - |
| Execution | Six Ministries | N/M completed | - |

## Task Status Overview
- Total tasks: N
- Completed: X
- Failed: Y
- Skipped: Z

### Per-Wave Breakdown
| Wave | Total | Completed | Failed | Skipped |
|------|-------|-----------|--------|---------|
| 1 | N | X | Y | Z |
| 2 | N | X | Y | Z |

### Per-Department Breakdown
| Department | Tasks | Completed | Artifacts |
|------------|-------|-----------|-----------|
| gongbu | N | X | artifacts/gongbu-output.md |
| bingbu | N | X | artifacts/bingbu-output.md |
| hubu | N | X | artifacts/hubu-output.md |
| libu | N | X | artifacts/libu-output.md |
| libu-hr | N | X | artifacts/libu-hr-output.md |
| xingbu | N | X | artifacts/xingbu-report.md |

## Department Output Summaries

### gongbu (Engineering)
<Summary from gongbu-output.md>

### bingbu (Operations)
<Summary from bingbu-output.md>

### hubu (Data & Resources)
<Summary from hubu-output.md>

### libu (Documentation)
<Summary from libu-output.md>

### libu-hr (Personnel)
<Summary from libu-hr-output.md>

### xingbu (Quality Assurance)
<Summary from xingbu-report.md>

## Quality Gate Results
| Gate | Phase | Score | Status |
|------|-------|-------|--------|
| Planning quality | zhongshu | XX% | PASS/WARN/FAIL |
| Review thoroughness | menxia | XX% | PASS/WARN/FAIL |
| Dispatch completeness | shangshu | XX% | PASS/WARN/FAIL |
| Execution quality | ministries | XX% | PASS/WARN/FAIL |
| QA verification | xingbu | XX% | PASS/WARN/FAIL |

## Key Discoveries
<Top N discoveries from discoveries.ndjson, grouped by type>

## Failures and Issues
<Any failed tasks, unresolved issues, or quality gate failures>

## Open Items
<Remaining work, if any>

Structured Output Template

## Summary
- Edict completion report generated: N/M tasks completed, quality gates: X PASS, Y WARN, Z FAIL

## Findings
- Per-department completion rates
- Quality gate scores
- Key discoveries count

## Deliverables
- File: <session>/context.md

## Open Questions
1. (any unresolved issues requiring user attention)

Error Handling

Scenario Resolution
Artifact file missing for a department Note as "Not produced" in report, mark quality gate as FAIL
tasks.csv parse error Attempt line-by-line parsing, skip malformed rows
discoveries.ndjson has malformed lines Skip malformed lines, continue with valid entries
Quality gate data insufficient Score as "Insufficient data", mark WARNING
No QA report (xingbu not assigned) Skip QA quality gate, note in report
Reference in New Issue View Git Blame Copy Permalink