maestro-flow 0.5.36 → 0.5.38

package/.claude/skills/skill-iter-tune/phases/05-report.md

@@ -1,166 +1,166 @@
-# Phase 5: Final Report
-
-> **COMPACT SENTINEL [Phase 5: Report]**
-> This phase contains 4 execution steps (Step 5.1 -- 5.4).
-> If you can read this sentinel but cannot find the full Step protocol below, context has been compressed.
-> Recovery: `Read("phases/05-report.md")`
-
-Generate comprehensive iteration history report and display results to user.
-
-## Objective
-
-- Read complete iteration state
-- Generate formatted final report with score progression
-- Write final-report.md
-- Display summary to user
-
-## Execution
-
-### Step 5.1: Read Complete State
-
-```javascript
-const state = JSON.parse(Read(`${state.work_dir}/iteration-state.json`));
-state.status = 'completed';
-state.updated_at = new Date().toISOString();
-```
-
-### Step 5.2: Generate Report
-
-```javascript
-// Determine outcome
-const outcomeMap = {
-  quality_threshold_met: 'PASSED -- Quality threshold reached',
-  max_iterations_reached: 'MAX ITERATIONS -- Threshold not reached',
-  convergence_detected: 'CONVERGED -- Score stopped improving',
-  error_limit_reached: 'FAILED -- Too many errors'
-};
-const outcome = outcomeMap[state.termination_reason] || 'COMPLETED';
-
-// Build score progression table
-const scoreTable = state.iterations
-  .filter(i => i.evaluation)
-  .map(i => {
-    const dims = i.evaluation.dimensions || [];
-    const dimScores = ['clarity', 'completeness', 'correctness', 'effectiveness', 'efficiency']
-      .map(id => {
-        const dim = dims.find(d => d.id === id);
-        return dim ? dim.score : '-';
-      });
-    return `| ${i.round} | ${i.evaluation.score} | ${dimScores.join(' | ')} |`;
-  }).join('\n');
-
-// Build iteration details
-const iterationDetails = state.iterations.map(iter => {
-  const evalSection = iter.evaluation
-    ? `**Score**: ${iter.evaluation.score}/100\n` +
-      `**Strengths**: ${iter.evaluation.strengths?.join(', ') || 'N/A'}\n` +
-      `**Weaknesses**: ${iter.evaluation.weaknesses?.slice(0, 3).join(', ') || 'N/A'}`
-    : '**Evaluation**: Skipped or failed';
-
-  const changesSection = iter.improvement
-    ? `**Changes Applied**: ${iter.improvement.changes_applied?.length || 0}\n` +
-      (iter.improvement.changes_applied?.map(c => `  - ${c.summary}`).join('\n') || '  None')
-    : '**Improvements**: None';
-
-  return `### Iteration ${iter.round}\n${evalSection}\n${changesSection}`;
-}).join('\n\n');
-
-const report = `# Skill Iter Tune -- Final Report
-
-## Summary
-
-| Field | Value |
-|-------|-------|
-| **Target Skills** | ${state.target_skills.map(s => s.name).join(', ')} |
-| **Execution Mode** | ${state.execution_mode} |
-${state.execution_mode === 'chain' ? `| **Chain Order** | ${state.chain_order.join(' -> ')} |` : ''}
-| **Test Scenario** | ${state.test_scenario.description} |
-| **Iterations** | ${state.iterations.length} |
-| **Initial Score** | ${state.score_trend[0] || 'N/A'} |
-| **Final Score** | ${state.latest_score}/100 |
-| **Quality Threshold** | ${state.quality_threshold} |
-| **Outcome** | ${outcome} |
-| **Started** | ${state.started_at} |
-| **Completed** | ${state.updated_at} |
-
-## Score Progression
-
-| Iter | Composite | Clarity | Completeness | Correctness | Effectiveness | Efficiency |
-|------|-----------|---------|--------------|-------------|---------------|------------|
-${scoreTable}
-
-**Trend**: ${state.score_trend.join(' -> ')}
-
-${state.execution_mode === 'chain' ? `
-## Chain Score Progression
-
-| Iter | ${state.chain_order.join(' | ')} |
-|------|${state.chain_order.map(() => '------').join('|')}|
-${state.iterations.filter(i => i.evaluation?.chain_scores).map(i => {
-  const scores = state.chain_order.map(s => i.evaluation.chain_scores[s] || '-');
-  return `| ${i.round} | ${scores.join(' | ')} |`;
-}).join('\n')}
-` : ''}
-
-## Iteration Details
-
-${iterationDetails}
-
-## Remaining Weaknesses
-
-${state.iterations.length > 0 && state.iterations[state.iterations.length - 1].evaluation
-  ? state.iterations[state.iterations.length - 1].evaluation.weaknesses?.map(w => `- ${w}`).join('\n') || 'None identified'
-  : 'No evaluation data available'}
-
-## Artifact Locations
-
-| Path | Description |
-|------|-------------|
-| \`${state.work_dir}/iteration-state.json\` | Complete state history |
-| \`${state.work_dir}/iterations/iteration-{N}/iteration-{N}-eval.md\` | Per-iteration evaluations |
-| \`${state.work_dir}/iterations/iteration-{N}/iteration-{N}-changes.md\` | Per-iteration change logs |
-| \`${state.work_dir}/final-report.md\` | This report |
-| \`${state.backup_dir}/\` | Original skill backups |
-
-## Restore Original
-
-To revert all changes and restore the original skill files:
-
-\`\`\`bash
-${state.target_skills.map(s => `cp -r "${state.backup_dir}/${s.name}"/* "${s.path}/"`).join('\n')}
-\`\`\`
-`;
-```
-
-### Step 5.3: Write Report and Update State
-
-```javascript
-Write(`${state.work_dir}/final-report.md`, report);
-
-state.status = 'completed';
-Write(`${state.work_dir}/iteration-state.json`, JSON.stringify(state, null, 2));
-```
-
-### Step 5.4: Display Summary to User
-
-Output to user:
-
-```
-Skill Iter Tune Complete!
-
-Target: {skill names}
-Iterations: {count}
-Score: {initial} -> {final} ({outcome})
-Threshold: {threshold}
-
-Score trend: {score1} -> {score2} -> ... -> {scoreN}
-
-Full report: {workDir}/final-report.md
-Backups: {backupDir}/
-```
-
-## Output
-
-- **Files**: `final-report.md`
-- **State**: `status = completed`
-- **Next**: Workflow complete. Return control to user.
+# Phase 5: Final Report
+
+> **COMPACT SENTINEL [Phase 5: Report]**
+> This phase contains 4 execution steps (Step 5.1 -- 5.4).
+> If you can read this sentinel but cannot find the full Step protocol below, context has been compressed.
+> Recovery: `Read("phases/05-report.md")`
+
+Generate comprehensive iteration history report and display results to user.
+
+## Objective
+
+- Read complete iteration state
+- Generate formatted final report with score progression
+- Write final-report.md
+- Display summary to user
+
+## Execution
+
+### Step 5.1: Read Complete State
+
+```javascript
+const state = JSON.parse(Read(`${state.work_dir}/iteration-state.json`));
+state.status = 'completed';
+state.updated_at = new Date().toISOString();
+```
+
+### Step 5.2: Generate Report
+
+```javascript
+// Determine outcome
+const outcomeMap = {
+  quality_threshold_met: 'PASSED -- Quality threshold reached',
+  max_iterations_reached: 'MAX ITERATIONS -- Threshold not reached',
+  convergence_detected: 'CONVERGED -- Score stopped improving',
+  error_limit_reached: 'FAILED -- Too many errors'
+};
+const outcome = outcomeMap[state.termination_reason] || 'COMPLETED';
+
+// Build score progression table
+const scoreTable = state.iterations
+  .filter(i => i.evaluation)
+  .map(i => {
+    const dims = i.evaluation.dimensions || [];
+    const dimScores = ['clarity', 'completeness', 'correctness', 'effectiveness', 'efficiency']
+      .map(id => {
+        const dim = dims.find(d => d.id === id);
+        return dim ? dim.score : '-';
+      });
+    return `| ${i.round} | ${i.evaluation.score} | ${dimScores.join(' | ')} |`;
+  }).join('\n');
+
+// Build iteration details
+const iterationDetails = state.iterations.map(iter => {
+  const evalSection = iter.evaluation
+    ? `**Score**: ${iter.evaluation.score}/100\n` +
+      `**Strengths**: ${iter.evaluation.strengths?.join(', ') || 'N/A'}\n` +
+      `**Weaknesses**: ${iter.evaluation.weaknesses?.slice(0, 3).join(', ') || 'N/A'}`
+    : '**Evaluation**: Skipped or failed';
+
+  const changesSection = iter.improvement
+    ? `**Changes Applied**: ${iter.improvement.changes_applied?.length || 0}\n` +
+      (iter.improvement.changes_applied?.map(c => `  - ${c.summary}`).join('\n') || '  None')
+    : '**Improvements**: None';
+
+  return `### Iteration ${iter.round}\n${evalSection}\n${changesSection}`;
+}).join('\n\n');
+
+const report = `# Skill Iter Tune -- Final Report
+
+## Summary
+
+| Field | Value |
+|-------|-------|
+| **Target Skills** | ${state.target_skills.map(s => s.name).join(', ')} |
+| **Execution Mode** | ${state.execution_mode} |
+${state.execution_mode === 'chain' ? `| **Chain Order** | ${state.chain_order.join(' -> ')} |` : ''}
+| **Test Scenario** | ${state.test_scenario.description} |
+| **Iterations** | ${state.iterations.length} |
+| **Initial Score** | ${state.score_trend[0] || 'N/A'} |
+| **Final Score** | ${state.latest_score}/100 |
+| **Quality Threshold** | ${state.quality_threshold} |
+| **Outcome** | ${outcome} |
+| **Started** | ${state.started_at} |
+| **Completed** | ${state.updated_at} |
+
+## Score Progression
+
+| Iter | Composite | Clarity | Completeness | Correctness | Effectiveness | Efficiency |
+|------|-----------|---------|--------------|-------------|---------------|------------|
+${scoreTable}
+
+**Trend**: ${state.score_trend.join(' -> ')}
+
+${state.execution_mode === 'chain' ? `
+## Chain Score Progression
+
+| Iter | ${state.chain_order.join(' | ')} |
+|------|${state.chain_order.map(() => '------').join('|')}|
+${state.iterations.filter(i => i.evaluation?.chain_scores).map(i => {
+  const scores = state.chain_order.map(s => i.evaluation.chain_scores[s] || '-');
+  return `| ${i.round} | ${scores.join(' | ')} |`;
+}).join('\n')}
+` : ''}
+
+## Iteration Details
+
+${iterationDetails}
+
+## Remaining Weaknesses
+
+${state.iterations.length > 0 && state.iterations[state.iterations.length - 1].evaluation
+  ? state.iterations[state.iterations.length - 1].evaluation.weaknesses?.map(w => `- ${w}`).join('\n') || 'None identified'
+  : 'No evaluation data available'}
+
+## Artifact Locations
+
+| Path | Description |
+|------|-------------|
+| \`${state.work_dir}/iteration-state.json\` | Complete state history |
+| \`${state.work_dir}/iterations/iteration-{N}/iteration-{N}-eval.md\` | Per-iteration evaluations |
+| \`${state.work_dir}/iterations/iteration-{N}/iteration-{N}-changes.md\` | Per-iteration change logs |
+| \`${state.work_dir}/final-report.md\` | This report |
+| \`${state.backup_dir}/\` | Original skill backups |
+
+## Restore Original
+
+To revert all changes and restore the original skill files:
+
+\`\`\`bash
+${state.target_skills.map(s => `cp -r "${state.backup_dir}/${s.name}"/* "${s.path}/"`).join('\n')}
+\`\`\`
+`;
+```
+
+### Step 5.3: Write Report and Update State
+
+```javascript
+Write(`${state.work_dir}/final-report.md`, report);
+
+state.status = 'completed';
+Write(`${state.work_dir}/iteration-state.json`, JSON.stringify(state, null, 2));
+```
+
+### Step 5.4: Display Summary to User
+
+Output to user:
+
+```
+Skill Iter Tune Complete!
+
+Target: {skill names}
+Iterations: {count}
+Score: {initial} -> {final} ({outcome})
+Threshold: {threshold}
+
+Score trend: {score1} -> {score2} -> ... -> {scoreN}
+
+Full report: {workDir}/final-report.md
+Backups: {backupDir}/
+```
+
+## Output
+
+- **Files**: `final-report.md`
+- **State**: `status = completed`
+- **Next**: Workflow complete. Return control to user.

package/.claude/skills/skill-iter-tune/specs/evaluation-criteria.md

@@ -1,63 +1,63 @@
-# Evaluation Criteria
-
-Skill 质量评估标准，由 Phase 03 (Evaluate) 引用。Gemini 按此标准对 skill 产出物进行多维度评分。
-
-## Dimensions
-
-| Dimension | Weight | ID | Description |
-|-----------|--------|----|-------------|
-| Clarity | 0.20 | clarity | 指令清晰无歧义，结构良好，易于遵循。Phase 文件有明确的 Step 划分、输入输出说明 |
-| Completeness | 0.25 | completeness | 覆盖所有必要阶段、边界情况、错误处理。没有遗漏关键执行路径 |
-| Correctness | 0.25 | correctness | 逻辑正确，数据流一致，Phase 间无矛盾。State schema 与实际使用匹配 |
-| Effectiveness | 0.20 | effectiveness | 在给定测试场景下能产出高质量输出。产物满足用户需求和成功标准 |
-| Efficiency | 0.10 | efficiency | 无冗余内容，上下文使用合理，不浪费 token。Phase 职责清晰无重叠 |
-
-## Scoring Guide
-
-| Range | Level | Description |
-|-------|-------|-------------|
-| 90-100 | Excellent | 生产级别，几乎无改进空间 |
-| 80-89 | Good | 可投入使用，仅需微调 |
-| 70-79 | Adequate | 功能可用，有明显可改进区域 |
-| 60-69 | Needs Work | 存在影响产出质量的显著问题 |
-| 0-59 | Poor | 结构或逻辑存在根本性问题 |
-
-## Composite Score Calculation
-
-```
-composite = sum(dimension.score * dimension.weight)
-```
-
-## Output JSON Schema
-
-```json
-{
-  "composite_score": 75,
-  "dimensions": [
-    { "name": "Clarity", "id": "clarity", "score": 80, "weight": 0.20, "feedback": "..." },
-    { "name": "Completeness", "id": "completeness", "score": 70, "weight": 0.25, "feedback": "..." },
-    { "name": "Correctness", "id": "correctness", "score": 78, "weight": 0.25, "feedback": "..." },
-    { "name": "Effectiveness", "id": "effectiveness", "score": 72, "weight": 0.20, "feedback": "..." },
-    { "name": "Efficiency", "id": "efficiency", "score": 85, "weight": 0.10, "feedback": "..." }
-  ],
-  "strengths": ["...", "...", "..."],
-  "weaknesses": ["...", "...", "..."],
-  "suggestions": [
-    {
-      "priority": "high",
-      "target_file": "phases/02-execute.md",
-      "description": "Add explicit error handling for CLI timeout",
-      "rationale": "Current phase has no recovery path when CLI execution exceeds timeout",
-      "code_snippet": "optional suggested replacement code"
-    }
-  ]
-}
-```
-
-## Evaluation Focus by Iteration
-
-| Iteration | Primary Focus |
-|-----------|--------------|
-| 1 | 全面评估，建立 baseline |
-| 2-3 | 重点关注上一轮 weaknesses 是否改善，避免重复已解决的问题 |
-| 4+ | 精细化改进，关注 Effectiveness 和 Efficiency |
+# Evaluation Criteria
+
+Skill 质量评估标准，由 Phase 03 (Evaluate) 引用。Agy 按此标准对 skill 产出物进行多维度评分。
+
+## Dimensions
+
+| Dimension | Weight | ID | Description |
+|-----------|--------|----|-------------|
+| Clarity | 0.20 | clarity | 指令清晰无歧义，结构良好，易于遵循。Phase 文件有明确的 Step 划分、输入输出说明 |
+| Completeness | 0.25 | completeness | 覆盖所有必要阶段、边界情况、错误处理。没有遗漏关键执行路径 |
+| Correctness | 0.25 | correctness | 逻辑正确，数据流一致，Phase 间无矛盾。State schema 与实际使用匹配 |
+| Effectiveness | 0.20 | effectiveness | 在给定测试场景下能产出高质量输出。产物满足用户需求和成功标准 |
+| Efficiency | 0.10 | efficiency | 无冗余内容，上下文使用合理，不浪费 token。Phase 职责清晰无重叠 |
+
+## Scoring Guide
+
+| Range | Level | Description |
+|-------|-------|-------------|
+| 90-100 | Excellent | 生产级别，几乎无改进空间 |
+| 80-89 | Good | 可投入使用，仅需微调 |
+| 70-79 | Adequate | 功能可用，有明显可改进区域 |
+| 60-69 | Needs Work | 存在影响产出质量的显著问题 |
+| 0-59 | Poor | 结构或逻辑存在根本性问题 |
+
+## Composite Score Calculation
+
+```
+composite = sum(dimension.score * dimension.weight)
+```
+
+## Output JSON Schema
+
+```json
+{
+  "composite_score": 75,
+  "dimensions": [
+    { "name": "Clarity", "id": "clarity", "score": 80, "weight": 0.20, "feedback": "..." },
+    { "name": "Completeness", "id": "completeness", "score": 70, "weight": 0.25, "feedback": "..." },
+    { "name": "Correctness", "id": "correctness", "score": 78, "weight": 0.25, "feedback": "..." },
+    { "name": "Effectiveness", "id": "effectiveness", "score": 72, "weight": 0.20, "feedback": "..." },
+    { "name": "Efficiency", "id": "efficiency", "score": 85, "weight": 0.10, "feedback": "..." }
+  ],
+  "strengths": ["...", "...", "..."],
+  "weaknesses": ["...", "...", "..."],
+  "suggestions": [
+    {
+      "priority": "high",
+      "target_file": "phases/02-execute.md",
+      "description": "Add explicit error handling for CLI timeout",
+      "rationale": "Current phase has no recovery path when CLI execution exceeds timeout",
+      "code_snippet": "optional suggested replacement code"
+    }
+  ]
+}
+```
+
+## Evaluation Focus by Iteration
+
+| Iteration | Primary Focus |
+|-----------|--------------|
+| 1 | 全面评估，建立 baseline |
+| 2-3 | 重点关注上一轮 weaknesses 是否改善，避免重复已解决的问题 |
+| 4+ | 精细化改进，关注 Effectiveness 和 Efficiency |