mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-10 17:11:04 +08:00
61ea9d47a6
- 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.
247 lines
6.7 KiB
Markdown
247 lines
6.7 KiB
Markdown
# 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)
|
|
|
|
```markdown
|
|
# 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 |
|