mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-01 14:03:54 +08:00
feat: Enhance workflow execution and documentation processes
- Added compact protection directives to execution phases to ensure critical instructions are preserved during context compression. - Introduced checkpoints in execution steps to verify active memory of execution protocols. - Created new command files for team lifecycle roles: - `dispatch.md`: Manage task chains based on execution modes. - `monitor.md`: Event-driven pipeline coordination with worker callbacks. - `critique.md`: Multi-perspective CLI critique for structured analysis. - `implement.md`: Multi-backend code implementation with retry and fallback mechanisms. - `explore.md`: Complexity-driven codebase exploration for task planning. - `generate-doc.md`: Multi-CLI document generation for various document types. - Updated SKILL.md to include compact protection patterns and phase reference documentation.
This commit is contained in:
@@ -714,55 +714,14 @@ executionContext = {
|
||||
}
|
||||
```
|
||||
|
||||
**Step 5.2: Serialize & Agent Handoff**
|
||||
|
||||
> **Why agent handoff**: Phase 1 history consumes significant context. Direct `Read("phases/02-lite-execute.md")` in the same context risks compact compressing Phase 2 instructions mid-execution. Spawning a fresh agent gives Phase 2 a clean context window.
|
||||
**Step 5.2: Handoff**
|
||||
|
||||
```javascript
|
||||
// Pre-populate _loadedTasks so serialized context is self-contained
|
||||
executionContext.planObject._loadedTasks = (executionContext.planObject.task_ids || []).map(id =>
|
||||
JSON.parse(Read(`${sessionFolder}/.task/${id}.json`))
|
||||
)
|
||||
|
||||
// Save executionContext to file for agent handoff
|
||||
Write(`${sessionFolder}/execution-context.json`, JSON.stringify(executionContext, null, 2))
|
||||
|
||||
// Resolve absolute path to Phase 2 instructions
|
||||
const phaseFile = Bash(`cd "${Bash('pwd').trim()}/.claude/skills/workflow-lite-plan/phases" && pwd`).trim()
|
||||
+ '/02-lite-execute.md'
|
||||
|
||||
// Agent handoff: fresh context prevents compact from losing Phase 2 instructions
|
||||
Task(
|
||||
subagent_type="universal-executor",
|
||||
run_in_background=false,
|
||||
description=`Execute: ${taskSlug}`,
|
||||
prompt=`
|
||||
Execute implementation plan following lite-execute protocol.
|
||||
|
||||
## Phase Instructions (MUST read first)
|
||||
Read and follow: ${phaseFile}
|
||||
|
||||
## Execution Context (Mode 1: In-Memory Plan)
|
||||
Read and parse as JSON: ${sessionFolder}/execution-context.json
|
||||
This is the executionContext variable referenced throughout Phase 2.
|
||||
The planObject._loadedTasks array is pre-populated — getTasks(planObject) works directly.
|
||||
|
||||
## Key References
|
||||
- Session ID: ${sessionId}
|
||||
- Session folder: ${sessionFolder}
|
||||
- Plan: ${sessionFolder}/plan.json
|
||||
- Task files: ${sessionFolder}/.task/TASK-*.json
|
||||
- Original task: ${task_description}
|
||||
|
||||
## Execution Steps
|
||||
1. Read phase instructions file (full protocol)
|
||||
2. Read execution-context.json → parse as executionContext
|
||||
3. Follow Phase 2 Mode 1 (In-Memory Plan) — executionContext exists, skip user selection
|
||||
4. Execute all tasks (Step 1-4 in Phase 2)
|
||||
5. Run code review if codeReviewTool ≠ "Skip" (Step 5)
|
||||
6. Run auto-sync (Step 6)
|
||||
`
|
||||
)
|
||||
// ⚠️ COMPACT PROTECTION: Phase 2 instructions MUST persist in memory throughout execution.
|
||||
// If compact compresses Phase 2 content at any point, re-read this file before continuing.
|
||||
// See SKILL.md "Compact Protection" section for full protocol.
|
||||
Read("phases/02-lite-execute.md")
|
||||
// Execute Phase 2 with executionContext (Mode 1: In-Memory Plan)
|
||||
```
|
||||
|
||||
## Session Folder Structure
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
# Phase 2: Lite-Execute
|
||||
|
||||
> **⚠️ COMPACT PROTECTION**: This is an active execution document — NOT reference material. During context compression, this directive MUST be preserved verbatim in the summary:
|
||||
> **"Phase 2 execution protocol has been compressed. MUST re-read `phases/02-lite-execute.md` before continuing any execution step. Do NOT proceed from summary alone."**
|
||||
|
||||
Complete execution engine: multi-mode input, task grouping, batch execution, code review, and development index update.
|
||||
|
||||
---
|
||||
@@ -354,6 +357,8 @@ TodoWrite({
|
||||
|
||||
### Step 3: Launch Execution
|
||||
|
||||
> **⚠️ CHECKPOINT**: Before proceeding, verify Phase 2 execution protocol (Step 3-5) is in active memory. If only a summary remains, re-read `phases/02-lite-execute.md` now.
|
||||
|
||||
**Executor Resolution**: `getTaskExecutor()` and `groupTasksByExecutor()` defined in Step 2 (Task Grouping).
|
||||
|
||||
**Batch Execution Routing** (根据 batch.executor 字段路由):
|
||||
@@ -574,6 +579,8 @@ Progress tracked at batch level (not individual task level). Icons: ⚡ (paralle
|
||||
|
||||
### Step 5: Code Review (Optional)
|
||||
|
||||
> **⚠️ CHECKPOINT**: Before proceeding, verify Phase 2 review protocol is in active memory. If only a summary remains, re-read `phases/02-lite-execute.md` now.
|
||||
|
||||
**Skip Condition**: Only run if `codeReviewTool ≠ "Skip"`
|
||||
|
||||
**Review Focus**: Verify implementation against plan convergence criteria and test requirements
|
||||
|
||||
Reference in New Issue
Block a user