@haoyiyin/workflow 0.2.0

package/dist/src/skills/tdd/index.js

@@ -0,0 +1,338 @@
+/**
+ * TDD Skill - Enforces RED/GREEN/REFACTOR cycle via subagent dispatch
+ *
+ * Use case: Implement feature with test-first approach
+ * Pattern: RED (write failing test) → GREEN (minimal implementation) →
+ *          REFACTOR (improve while green) → VERIFY (full suite)
+ *
+ * Spawns implementer subagent with TDD contract at each phase.
+ * Enforces the cycle: no implementation before a failing test exists.
+ */
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import { createDispatcher } from '../../agents/dispatcher.js';
+import { createMainAgentGuard } from '../../guard/main-agent.js';
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+const TDDInputSchema = z.object({
+    behavior: z.string().min(1, 'Behavior to implement is required'),
+    testFile: z.string().optional(),
+    targetFile: z.string().min(1, 'Target implementation file is required'),
+    testLevel: z
+        .enum(['unit', 'integration', 'e2e', 'contract'])
+        .default('unit'),
+    model: z.string().optional(),
+});
+const PhaseResultSchema = z.object({
+    phase: z.enum(['red', 'green', 'refactor']),
+    status: z.enum(['pass', 'fail', 'skipped']),
+    command: z.string(),
+    evidence: z.string(),
+});
+const TDDOutputSchema = z.object({
+    status: z.enum(['success', 'failure', 'invalid-red']),
+    phases: z.array(PhaseResultSchema),
+    broaderVerification: z.object({
+        command: z.string(),
+        result: z.enum(['PASS', 'FAIL', 'NOT_RUN']),
+    }),
+    filesModified: z.array(z.string()),
+    summary: z.string(),
+    tokensUsed: z.number(),
+});
+// ---------------------------------------------------------------------------
+// Prompt builders (pure functions)
+// ---------------------------------------------------------------------------
+function buildRedPrompt(behavior, targetFile, testFile, testLevel) {
+    return [
+        `## TDD Phase: RED - Write Failing Test`,
+        '',
+        `**Behavior**: ${behavior}`,
+        `**Test Level**: ${testLevel}`,
+        `**Target File**: ${targetFile}`,
+        testFile ? `**Test File**: ${testFile}` : '',
+        '',
+        '## Instructions',
+        '',
+        '1. Read the target file to understand current state',
+        '2. Write a minimal, focused test that MUST fail',
+        '3. The test should describe the expected behavior precisely',
+        '4. Run the test and confirm it FAILS for the RIGHT reason',
+        '',
+        '## Validation',
+        '',
+        '- Test must fail because the behavior is NOT yet implemented',
+        '- If the test PASSES immediately, the behavior may already exist',
+        '- If test fails due to setup/syntax error, fix the test first',
+        '',
+        '## Anti-Goals',
+        '',
+        '- Do NOT implement the feature',
+        '- Do NOT write more than one test',
+        '- Do NOT modify the target file',
+        '',
+        '## Output',
+        '',
+        'Report: test file path, test command used, test output (must show FAIL).',
+        'If test unexpectedly passes, output: INVALID_RED',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+function buildGreenPrompt(behavior, targetFile, testFile, redEvidence) {
+    return [
+        `## TDD Phase: GREEN - Make Test Pass`,
+        '',
+        `**Behavior**: ${behavior}`,
+        `**Target File**: ${targetFile}`,
+        testFile ? `**Test File**: ${testFile}` : '',
+        '',
+        '## RED Phase Evidence',
+        redEvidence.slice(0, 500),
+        '',
+        '## Instructions',
+        '',
+        '1. Read the failing test to understand what is expected',
+        '2. Write the MINIMAL code to make the test pass',
+        '3. Code can be hacky, hardcoded, or ugly — refactor comes next',
+        '4. Run the test and confirm it PASSES',
+        '',
+        '## Anti-Goals',
+        '',
+        '- Do NOT refactor or prettify the code',
+        '- Do NOT add features beyond what the test checks',
+        '- Do NOT change the test',
+        '- Do NOT write additional tests',
+        '',
+        '## Output',
+        '',
+        'Report: implementation summary, test command, test output (must show PASS).',
+    ].join('\n');
+}
+function buildRefactorPrompt(targetFile) {
+    return [
+        `## TDD Phase: REFACTOR - Clean Up`,
+        '',
+        `**Target File**: ${targetFile}`,
+        '',
+        '## Instructions',
+        '',
+        '1. Read the current implementation',
+        '2. Improve code quality: remove duplication, better naming, extract helpers',
+        '3. Run tests after EACH change to stay green',
+        '4. Run the full test suite at the end',
+        '',
+        '## Allowed',
+        '',
+        '- Rename variables/functions for clarity',
+        '- Extract repeated logic into helper functions',
+        '- Add type annotations',
+        '- Reorganize code for readability',
+        '',
+        '## Anti-Goals',
+        '',
+        '- Do NOT change behavior',
+        '- Do NOT add new features',
+        '- Do NOT modify test expectations',
+        '- Do NOT break any test',
+        '',
+        '## Output',
+        '',
+        'Report: what was refactored, test command, test output (must show ALL PASS).',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Skill class
+// ---------------------------------------------------------------------------
+export class TDDSkill extends Skill {
+    constructor() {
+        super({
+            name: 'tdd',
+            description: 'Enforce RED/GREEN/REFACTOR TDD cycle with isolated implementer subagents',
+            requires: [],
+            inputSchema: TDDInputSchema,
+            outputSchema: TDDOutputSchema,
+        });
+    }
+    async execute(input, context) {
+        const { config, logger } = context;
+        const dispatcher = createDispatcher(logger);
+        const guard = createMainAgentGuard({}, logger);
+        const phases = [];
+        const filesModified = [];
+        let totalTokens = 0;
+        guard.activateEmbargo();
+        try {
+            // ---- Phase 1: RED - Write failing test ----
+            logger.info(`[tdd] RED phase: writing failing test for "${input.behavior}"`);
+            const redResult = await dispatcher.dispatch({
+                role: 'implementer',
+                model: input.model || config.defaultModel,
+                isolation: 'worktree',
+            }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: true,
+                    gitOperations: false,
+                },
+                prompt: buildRedPrompt(input.behavior, input.targetFile, input.testFile, input.testLevel),
+                owns: input.testFile ? [input.testFile] : [],
+                reads: [input.targetFile],
+            });
+            totalTokens += redResult.tokensUsed;
+            if (redResult.output.includes('INVALID_RED')) {
+                return {
+                    status: 'invalid-red',
+                    phases,
+                    broaderVerification: { command: '', result: 'NOT_RUN' },
+                    filesModified,
+                    summary: 'RED phase invalid: behavior may already exist or test is misconfigured',
+                    tokensUsed: totalTokens,
+                };
+            }
+            if (redResult.status !== 'success') {
+                phases.push({
+                    phase: 'red',
+                    status: 'fail',
+                    command: '',
+                    evidence: redResult.errors.join(', '),
+                });
+                return {
+                    status: 'failure',
+                    phases,
+                    broaderVerification: { command: '', result: 'NOT_RUN' },
+                    filesModified,
+                    summary: `RED phase failed: ${redResult.errors.join(', ')}`,
+                    tokensUsed: totalTokens,
+                };
+            }
+            phases.push({
+                phase: 'red',
+                status: 'pass',
+                command: '(test runner)',
+                evidence: redResult.output.slice(0, 300),
+            });
+            if (input.testFile)
+                filesModified.push(input.testFile);
+            // ---- Phase 2: GREEN - Make test pass ----
+            logger.info('[tdd] GREEN phase: implementing minimal code');
+            const greenResult = await dispatcher.dispatch({
+                role: 'implementer',
+                model: input.model || config.defaultModel,
+                isolation: 'worktree',
+            }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: true,
+                    gitOperations: false,
+                },
+                prompt: buildGreenPrompt(input.behavior, input.targetFile, input.testFile, redResult.output),
+                owns: [input.targetFile],
+                reads: [],
+            });
+            totalTokens += greenResult.tokensUsed;
+            if (greenResult.status !== 'success') {
+                phases.push({
+                    phase: 'green',
+                    status: 'fail',
+                    command: '',
+                    evidence: greenResult.errors.join(', '),
+                });
+                return {
+                    status: 'failure',
+                    phases,
+                    broaderVerification: { command: '', result: 'NOT_RUN' },
+                    filesModified,
+                    summary: `GREEN phase failed: ${greenResult.errors.join(', ')}`,
+                    tokensUsed: totalTokens,
+                };
+            }
+            phases.push({
+                phase: 'green',
+                status: 'pass',
+                command: '(test runner)',
+                evidence: greenResult.output.slice(0, 300),
+            });
+            filesModified.push(input.targetFile);
+            // ---- Phase 3: REFACTOR - Clean up while staying green ----
+            logger.info('[tdd] REFACTOR phase: improving code quality');
+            const refactorResult = await dispatcher.dispatch({
+                role: 'implementer',
+                model: input.model || config.defaultModel,
+                isolation: 'worktree',
+            }, {
+                permissions: {
+                    readFiles: true,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: true,
+                    gitOperations: false,
+                },
+                prompt: buildRefactorPrompt(input.targetFile),
+                owns: [input.targetFile],
+                reads: [],
+            });
+            totalTokens += refactorResult.tokensUsed;
+            phases.push({
+                phase: 'refactor',
+                status: refactorResult.status === 'success' ? 'pass' : 'skipped',
+                command: '(test runner)',
+                evidence: refactorResult.output.slice(0, 300),
+            });
+            // ---- Phase 4: Broader verification ----
+            logger.info('[tdd] Running broader verification');
+            const verifyResult = await dispatcher.dispatch({
+                role: 'verifier',
+                model: input.model || config.defaultModel,
+            }, {
+                permissions: {
+                    readFiles: false,
+                    searchCode: false,
+                    runCommands: true,
+                    writeFiles: false,
+                    gitOperations: false,
+                },
+                prompt: [
+                    'Run broader verification for the TDD implementation:',
+                    '',
+                    `Behavior: ${input.behavior}`,
+                    `Target: ${input.targetFile}`,
+                    '',
+                    '1. Run the full test suite (not just the new test)',
+                    '2. Check for regressions',
+                    '3. Verify the behavior works end-to-end if applicable',
+                    '',
+                    'Return: command executed, exit code, summary of results.',
+                ].join('\n'),
+                owns: [],
+                reads: [],
+            });
+            totalTokens += verifyResult.tokensUsed;
+            const redStatus = phases[0]?.status ?? 'fail';
+            const greenStatus = phases[1]?.status ?? 'fail';
+            const refactorStatus = phases[2]?.status ?? 'skipped';
+            return {
+                status: 'success',
+                phases,
+                broaderVerification: {
+                    command: '(verification)',
+                    result: verifyResult.status === 'success' ? 'PASS' : 'FAIL',
+                },
+                filesModified: [...new Set(filesModified)],
+                summary: `TDD complete: RED(${redStatus}) → GREEN(${greenStatus}) → REFACTOR(${refactorStatus}). Used ${totalTokens} tokens.`,
+                tokensUsed: totalTokens,
+            };
+        }
+        finally {
+            guard.deactivateEmbargo();
+        }
+    }
+}
+export const tddSkill = new TDDSkill();
+export default tddSkill;
+//# sourceMappingURL=index.js.map

package/dist/src/skills/tdd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/skills/tdd/index.ts"],"names":[],"mappings":"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"}

package/dist/src/skills/to-plan/index-enhanced.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Enhanced Plan Skill - Orchestrates analysis, debugging, and planning
+ *
+ * Architecture: Orchestrator pattern
+ * - Analyzes input to determine what preprocessing is needed
+ * - May spawn debugging subagent for bug investigation
+ * - Delegates actual planning to planner subagent
+ * - Wave grouping and validation
+ *
+ * Examples:
+ *   "/to-plan 实现登录功能" → Direct planning
+ *   "/to-plan 出现xxbug，查明原因并制定计划" → Debug → Plan
+ *   "/to-plan 性能问题，先分析再计划" → Explore → Plan
+ */
+import { z } from 'zod';
+import { Skill } from '../skill.js';
+import type { SkillContext } from '../types.js';
+import type { Plan, Wave } from '../../persistence/types.js';
+declare const PlanInputSchema: z.ZodObject<{
+    goal: z.ZodString;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    model: z.ZodOptional<z.ZodString>;
+    previousIssues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    symptom: z.ZodOptional<z.ZodString>;
+    reproduceCommand: z.ZodOptional<z.ZodString>;
+    logs: z.ZodOptional<z.ZodString>;
+    recentChanges: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    goal: string;
+    model?: string | undefined;
+    symptom?: string | undefined;
+    reproduceCommand?: string | undefined;
+    logs?: string | undefined;
+    recentChanges?: string | undefined;
+    constraints?: string[] | undefined;
+    previousIssues?: string[] | undefined;
+}, {
+    goal: string;
+    model?: string | undefined;
+    symptom?: string | undefined;
+    reproduceCommand?: string | undefined;
+    logs?: string | undefined;
+    recentChanges?: string | undefined;
+    constraints?: string[] | undefined;
+    previousIssues?: string[] | undefined;
+}>;
+declare const PlanOutputSchema: z.ZodObject<{
+    plan: z.ZodType<Plan, z.ZodTypeDef, Plan>;
+    waves: z.ZodArray<z.ZodType<Wave, z.ZodTypeDef, Wave>, "many">;
+    rootCause: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    analysisPerformed: z.ZodBoolean;
+    tokensUsed: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    tokensUsed: number;
+    plan: Plan;
+    waves: Wave[];
+    analysisPerformed: boolean;
+    rootCause?: string | undefined;
+    confidence?: "low" | "medium" | "high" | undefined;
+}, {
+    tokensUsed: number;
+    plan: Plan;
+    waves: Wave[];
+    analysisPerformed: boolean;
+    rootCause?: string | undefined;
+    confidence?: "low" | "medium" | "high" | undefined;
+}>;
+type PlanInput = z.infer<typeof PlanInputSchema>;
+type PlanOutput = z.infer<typeof PlanOutputSchema>;
+export declare class ToPlanSkill extends Skill<PlanInput, PlanOutput> {
+    protected name: string;
+    protected description: string;
+    protected requires: string[];
+    execute(input: PlanInput, context: SkillContext): Promise<PlanOutput>;
+    /**
+     * Analyze input to determine what preprocessing is needed
+     */
+    private analyzeInput;
+    /**
+     * Run systematic debugging using debugging skill
+     */
+    private runDebugging;
+    /**
+     * Run exploration to gather context
+     */
+    private runExploration;
+    /**
+     * Spawn planner subagent with fresh context
+     */
+    private spawnPlannerSubagent;
+    private buildDebuggingPrompt;
+    private buildPlannerPrompt;
+    private parsePlanResponse;
+    private validatePlan;
+    private groupIntoWaves;
+    private triggerHook;
+}
+export {};
+//# sourceMappingURL=index-enhanced.d.ts.map

package/dist/src/skills/to-plan/index-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-enhanced.d.ts","sourceRoot":"","sources":["../../../../src/skills/to-plan/index-enhanced.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAQ,IAAI,EAAE,MAAM,4BAA4B,CAAA;AAQlE,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUnB,CAAA;AAEF,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EASpB,CAAA;AAEF,KAAK,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAChD,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAElD,qBAAa,WAAY,SAAQ,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC;IAC3D,SAAS,CAAC,IAAI,SAAY;IAC1B,SAAS,CAAC,WAAW,SAAgF;IACrG,SAAS,CAAC,QAAQ,WAAyC;IAErD,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAqH3E;;OAEG;IACH,OAAO,CAAC,YAAY;IAyCpB;;OAEG;YACW,YAAY;IAsD1B;;OAEG;YACW,cAAc;IAwC5B;;OAEG;YACW,oBAAoB;IA2BlC,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,kBAAkB;IAyC1B,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,YAAY;IAsDpB,OAAO,CAAC,cAAc;YAkCR,WAAW;CAe1B"}