mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-15 02:42:45 +08:00
6054a01b8f
- Implemented CLI fallback using `ccw team` for various team command operations in `execute.md`, `plan.md`, `review.md`, `spec-analyst.md`, `spec-coordinate.md`, `spec-discuss.md`, `spec-reviewer.md`, `spec-writer.md`, and `test.md`. - Updated command generation templates to include CLI fallback examples. - Enhanced validation checks to ensure CLI fallback sections are present. - Added quality standards for CLI fallback in team command design. - Introduced a new `GlobalGraphExpander` class for expanding search results with cross-directory relationships. - Added tests for `GlobalGraphExpander` to verify functionality and score decay factors.
127 lines
4.1 KiB
Markdown
127 lines
4.1 KiB
Markdown
# Quality Standards for Team Commands
|
|
|
|
Quality assessment criteria for generated team command .md files.
|
|
|
|
## When to Use
|
|
|
|
| Phase | Usage | Section |
|
|
|-------|-------|---------|
|
|
| Phase 5 | Score generated command | All dimensions |
|
|
| Phase 3 | Guide generation quality | Checklist |
|
|
|
|
---
|
|
|
|
## Quality Dimensions
|
|
|
|
### 1. Completeness (25%)
|
|
|
|
| Score | Criteria |
|
|
|-------|----------|
|
|
| 100% | All 15 required sections present with substantive content |
|
|
| 80% | 12+ sections present, minor gaps in non-critical areas |
|
|
| 60% | Core sections present (front matter, message bus, 5 phases, error handling) |
|
|
| 40% | Missing critical sections |
|
|
| 0% | Skeleton only |
|
|
|
|
**Required Sections Checklist:**
|
|
- [ ] YAML front matter with `group: team`
|
|
- [ ] Overview with core capabilities
|
|
- [ ] Role Definition (name, responsibility, communication)
|
|
- [ ] Message Bus section with team_msg examples
|
|
- [ ] Message Types table
|
|
- [ ] Execution Process overview diagram
|
|
- [ ] Phase 1: Task Discovery implementation
|
|
- [ ] Phase 2: Context Loading implementation
|
|
- [ ] Phase 3: Core Work implementation
|
|
- [ ] Phase 4: Validation/Summary implementation
|
|
- [ ] Phase 5: Report + Loop implementation
|
|
- [ ] Error Handling table
|
|
- [ ] Code examples in all phases
|
|
|
|
### 2. Pattern Compliance (25%)
|
|
|
|
| Score | Criteria |
|
|
|-------|----------|
|
|
| 100% | All 8 infrastructure patterns + selected collaboration patterns fully implemented |
|
|
| 80% | 6 core infra patterns + at least 1 collaboration pattern with convergence |
|
|
| 60% | Minimum 6 infra patterns, collaboration patterns present but incomplete |
|
|
| 40% | Missing critical patterns (message bus or task lifecycle) |
|
|
| 0% | No pattern compliance |
|
|
|
|
**Infrastructure Pattern Checklist:**
|
|
- [ ] Pattern 1: Message bus - team_msg before every SendMessage
|
|
- [ ] Pattern 1b: CLI fallback - `ccw team` CLI fallback section with parameter mapping
|
|
- [ ] Pattern 2: YAML front matter - all fields present, group: team
|
|
- [ ] Pattern 3: Task lifecycle - TaskList/Get/Update flow
|
|
- [ ] Pattern 4: Five-phase structure - all 5 phases present
|
|
- [ ] Pattern 5: Complexity-adaptive (if applicable)
|
|
- [ ] Pattern 6: Coordinator spawn compatible
|
|
- [ ] Pattern 7: Error handling table
|
|
- [ ] Pattern 8: Session files (if applicable)
|
|
|
|
**Collaboration Pattern Checklist:**
|
|
- [ ] At least one CP selected (CP-1 minimum)
|
|
- [ ] Each selected CP has convergence criteria defined
|
|
- [ ] Each selected CP has feedback loop mechanism
|
|
- [ ] Each selected CP has timeout/fallback behavior
|
|
- [ ] CP-specific message types registered in message bus section
|
|
- [ ] Escalation path defined (CP-5) for error scenarios
|
|
|
|
### 3. Integration (25%)
|
|
|
|
| Score | Criteria |
|
|
|-------|----------|
|
|
| 100% | All integration checks pass, spawn snippet ready |
|
|
| 80% | Minor integration notes, no blocking issues |
|
|
| 60% | Some checks need attention but functional |
|
|
| 40% | Task prefix conflict or missing critical tools |
|
|
| 0% | Incompatible with team system |
|
|
|
|
### 4. Consistency (25%)
|
|
|
|
| Score | Criteria |
|
|
|-------|----------|
|
|
| 100% | Role name, task prefix, message types consistent throughout |
|
|
| 80% | Minor inconsistencies in non-critical areas |
|
|
| 60% | Some mixed terminology but intent clear |
|
|
| 40% | Confusing or contradictory content |
|
|
| 0% | Internally inconsistent |
|
|
|
|
---
|
|
|
|
## Quality Gates
|
|
|
|
| Gate | Threshold | Action |
|
|
|------|-----------|--------|
|
|
| PASS | >= 80% | Deliver to `.claude/commands/team/{team-name}/` |
|
|
| REVIEW | 60-79% | Fix recommendations, re-validate |
|
|
| FAIL | < 60% | Major rework needed, re-run from Phase 3 |
|
|
|
|
---
|
|
|
|
## Issue Classification
|
|
|
|
### Errors (Must Fix)
|
|
|
|
- Missing YAML front matter
|
|
- Missing `group: team`
|
|
- No message bus section
|
|
- No task lifecycle (TaskList/Get/Update)
|
|
- No SendMessage to coordinator
|
|
- Task prefix conflicts with existing
|
|
|
|
### Warnings (Should Fix)
|
|
|
|
- Missing error handling table
|
|
- Incomplete Phase implementation (skeleton only)
|
|
- Missing team_msg before some SendMessage calls
|
|
- Missing CLI fallback section (`### CLI 回退` with `ccw team` examples)
|
|
- No complexity-adaptive routing when role is complex
|
|
|
|
### Info (Nice to Have)
|
|
|
|
- Code examples could be more detailed
|
|
- Additional message type examples
|
|
- Session file structure documentation
|
|
- CLI integration examples
|