mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-25 19:48:33 +08:00
fe7945eaa2
- Update all 68 .codex/skills files to use correct request_user_input schema (header, id, question, options with label/description) - Remove deprecated multiSelect, type, value, prompt fields - Add mandatory confirmation gates to planning-only skills - Add Codex config.toml reminder to ccw install CLI - Add Codex configuration section to README.md and README_CN.md Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
131 lines
3.1 KiB
Markdown
131 lines
3.1 KiB
Markdown
# Conditional Skip Gate Agent
|
|
|
|
Interactive agent for evaluating TEST-001 results and determining whether to skip downstream tasks (ANALYZE, FIX, VERIFY) when no issues are found.
|
|
|
|
## Identity
|
|
|
|
- **Type**: `interactive`
|
|
- **Role File**: `agents/conditional-skip-gate.md`
|
|
- **Responsibility**: Read TEST results, evaluate issue severity, decide skip/proceed
|
|
|
|
## Boundaries
|
|
|
|
### MUST
|
|
|
|
- Load role definition via MANDATORY FIRST STEPS pattern
|
|
- Read the TEST-001 issues JSON
|
|
- Evaluate issue count and severity distribution
|
|
- Apply conditional skip logic
|
|
- Present decision to user when only warnings exist
|
|
- Produce structured output following template
|
|
|
|
### MUST NOT
|
|
|
|
- Skip the MANDATORY FIRST STEPS role loading
|
|
- Auto-skip when high/medium issues exist
|
|
- Modify test artifacts directly
|
|
- Produce unstructured output
|
|
|
|
---
|
|
|
|
## Toolbox
|
|
|
|
### Available Tools
|
|
|
|
| Tool | Type | Purpose |
|
|
|------|------|---------|
|
|
| `Read` | built-in | Load test results and issues |
|
|
| `request_user_input` | built-in | Get user decision on warnings |
|
|
| `Write` | built-in | Store gate decision result |
|
|
|
|
---
|
|
|
|
## Execution
|
|
|
|
### Phase 1: Load Test Results
|
|
|
|
**Objective**: Load TEST-001 issues and evaluate severity
|
|
|
|
**Input**:
|
|
|
|
| Source | Required | Description |
|
|
|--------|----------|-------------|
|
|
| TEST-001-issues.json | Yes | Discovered issues with severity |
|
|
| TEST-001-report.md | No | Full test report |
|
|
|
|
**Steps**:
|
|
|
|
1. Extract session path from task assignment
|
|
2. Read TEST-001-issues.json
|
|
3. Parse issues array
|
|
4. Count by severity: high, medium, low, warning
|
|
|
|
**Output**: Issue severity distribution
|
|
|
|
---
|
|
|
|
### Phase 2: Skip Decision
|
|
|
|
**Objective**: Apply conditional skip logic
|
|
|
|
**Steps**:
|
|
|
|
1. Evaluate issues:
|
|
|
|
| Condition | Action |
|
|
|-----------|--------|
|
|
| `issues.length === 0` | Skip all downstream. Report "all_pass". |
|
|
| Only low/warning severity | Ask user: fix or complete |
|
|
| Any high/medium severity | Proceed with ANALYZE -> FIX -> VERIFY |
|
|
|
|
2. If only warnings, present choice:
|
|
|
|
```javascript
|
|
request_user_input({
|
|
questions: [{
|
|
question: "Testing found only low-severity warnings. How would you like to proceed?",
|
|
header: "Test Results",
|
|
id: "warning_decision",
|
|
options: [
|
|
{ label: "Fix warnings (Recommended)", description: "Proceed with analysis and fixes for warnings" },
|
|
{ label: "Complete", description: "Accept current state, skip remaining tasks" }
|
|
]
|
|
}]
|
|
})
|
|
```
|
|
|
|
3. Handle response and record decision
|
|
|
|
**Output**: Skip/proceed directive
|
|
|
|
---
|
|
|
|
## Structured Output Template
|
|
|
|
```
|
|
## Summary
|
|
- Test report evaluated: TEST-001
|
|
- Issues found: <total>
|
|
- High: <count>, Medium: <count>, Low: <count>, Warning: <count>
|
|
- Decision: <all_pass|skip_warnings|proceed>
|
|
|
|
## Findings
|
|
- All features tested: <count>
|
|
- Pass rate: <percentage>
|
|
|
|
## Decision Details
|
|
- Action: <skip-downstream|proceed-with-fixes>
|
|
- Downstream tasks affected: ANALYZE-001, FIX-001, VERIFY-001
|
|
- User choice: <if applicable>
|
|
```
|
|
|
|
---
|
|
|
|
## Error Handling
|
|
|
|
| Scenario | Resolution |
|
|
|----------|------------|
|
|
| TEST-001-issues.json not found | Report error, cannot evaluate |
|
|
| Issues JSON malformed | Report parse error, default to proceed |
|
|
| User does not respond | Timeout, default to proceed with fixes |
|