@haoyiyin/workflow 0.2.4 → 0.2.7

package/SKILL.md

@@ -13,31 +13,28 @@ Use this skill when the user wants to:
 
 ## Commands
 
-All yi-workflow commands are prefixed with `ywf-` to avoid conflicts with PI native commands:
+All skills are registered with PI and available via `/skill:<name>`:
 
-### /ywf-plan <goal>
+### /skill:to-plan <goal>
 Create an execution plan for the given goal.
 
-### /ywf-execute
+### /skill:execute-plan
 Execute the current plan.
 
-### /ywf-task <description>
+### /skill:quick-task <description>
 Execute a quick task without planning.
 
-### /ywf-tdd <feature>
+### /skill:tdd <feature>
 Implement feature using TDD approach.
 
-### /ywf-review [target]
+### /skill:review-diff [target]
 Review code changes.
 
-### /ywf-debug <issue>
+### /skill:systematic-debugging <issue>
 Debug an issue systematically.
 
-### /ywf-status
-Show current workflow status.
-
-### /ywf-resume
-Resume interrupted workflow.
+### /skill:agents-md
+Create or update agent instruction files.
 
 ## Workflow
 

package/dist/src/extension/classifier.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Intent classifier for user input
+ * Maps natural language to yi-workflow skills
+ */
+export interface IntentResult {
+    skill?: string;
+    confidence: "high" | "medium" | "low";
+    reason: string;
+}
+/**
+ * Classify user intent and return appropriate skill
+ */
+export declare function classifyIntent(message: string): IntentResult;
+/**
+ * Check if input should be dispatched to a skill
+ */
+export declare function shouldDispatch(message: string): boolean;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/src/extension/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../src/extension/classifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAyI5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/src/extension/classifier.js

@@ -0,0 +1,143 @@
+/**
+ * Intent classifier for user input
+ * Maps natural language to yi-workflow skills
+ */
+/**
+ * Classify user intent and return appropriate skill
+ */
+export function classifyIntent(message) {
+    const lower = message.toLowerCase().trim();
+    // Pattern definitions with priority
+    const patterns = [
+        // High confidence patterns
+        {
+            skill: "to-plan",
+            confidence: "high",
+            patterns: [
+                /^(plan|design|architect)\b/i,
+                /^(create|make|write).*\bplan\b/i,
+                /^(how|what).*\b(approach|strategy)\b/i,
+                /^(break|split|divide).*\b(down|into)\b/i,
+                /\b(plan|design)\b.*\b(feature|module|system)\b/i,
+                /\bimplement\b.*\bplan\b/i,
+            ],
+            reason: "Detected planning/architecture intent",
+        },
+        {
+            skill: "execute-plan",
+            confidence: "high",
+            patterns: [
+                /^(execute|run|implement)\b.*\bplan\b/i,
+                /^(start|begin|proceed)\b.*\bimplement/i,
+                /\bplan\b.*\b(approved|ready)\b/i,
+                /^(continue|resume)\b.*\b(workflow|execution)\b/i,
+            ],
+            reason: "Detected execution intent",
+        },
+        {
+            skill: "systematic-debugging",
+            confidence: "high",
+            patterns: [
+                /^(debug|fix|investigate|trace)\b/i,
+                /\b(bug|error|crash|fail)\b/i,
+                /\b(broken|not working|issue|problem)\b/i,
+                /\b(intermittent|flaky)\b/i,
+                /\b(root cause|diagnose)\b/i,
+            ],
+            reason: "Detected debugging intent",
+        },
+        {
+            skill: "tdd",
+            confidence: "high",
+            patterns: [
+                /\btdd\b/i,
+                /^(test|write test).*\bfirst\b/i,
+                /\bred.?green.?refactor\b/i,
+                /\b(test driven|test-driven)\b/i,
+                /^(add|write).*\btest\b.*\b(for|before)\b/i,
+            ],
+            reason: "Detected TDD intent",
+        },
+        {
+            skill: "review-diff",
+            confidence: "high",
+            patterns: [
+                /^(review|audit|inspect)\b/i,
+                /\b(code|pull|pr)\b.*\breview\b/i,
+                /\b(quality|check|verify)\b.*\bcode\b/i,
+                /\blooks\b.*\b(good|correct|ok)\b.*/i,
+            ],
+            reason: "Detected review intent",
+        },
+        {
+            skill: "agents-md",
+            confidence: "high",
+            patterns: [
+                /\b(CLAUDE|AGENTS|CONTEXT)\.md\b/i,
+                /^(create|update|write).*\b(agent|context|instruction)\b.*\b(file|md)\b/i,
+                /\b(agent instruction|system prompt)\b/i,
+            ],
+            reason: "Detected agent file creation intent",
+        },
+        {
+            skill: "quick-task",
+            confidence: "high",
+            patterns: [
+                /\b(typo|fix typo|rename|import|config)\b/i,
+                /^(quick|small|simple|minor)\b.*\b(fix|change|update)\b/i,
+                /\bversion bump\b/i,
+                /\bgitignore\b/i,
+                /^(add|remove|update)\s+\w+\s*$/i, // Single word tasks
+            ],
+            reason: "Detected quick task intent",
+        },
+        // Medium confidence patterns
+        {
+            skill: "to-plan",
+            confidence: "medium",
+            patterns: [
+                /\b(need|want)\b.*\bplan\b/i,
+                /\b(implement|build|create)\b.*\b(feature|function)\b/i,
+            ],
+            reason: "Potential planning intent",
+        },
+        {
+            skill: "quick-task",
+            confidence: "medium",
+            patterns: [
+                /^(fix|update|change|rename|add|remove)\b/i,
+                /\b(update|change)\b.*\b(config|setting|value)\b/i,
+            ],
+            reason: "Potential quick task intent",
+        },
+        // Low confidence catch-all
+        {
+            skill: "quick-task",
+            confidence: "low",
+            patterns: [
+                /^(do|make|help)\b/i,
+                /\b(can you|could you)\b/i,
+            ],
+            reason: "Unclear intent - using quick-task for exploration",
+        },
+    ];
+    // Find first matching pattern
+    for (const { skill, confidence, patterns: pats, reason } of patterns) {
+        if (pats.some((p) => p.test(lower))) {
+            return { skill, confidence, reason };
+        }
+    }
+    // No match - return with fallback suggestion
+    return {
+        confidence: "low",
+        reason: "No clear intent detected",
+    };
+}
+/**
+ * Check if input should be dispatched to a skill
+ */
+export function shouldDispatch(message) {
+    const result = classifyIntent(message);
+    return result.skill !== undefined;
+}
+//# sourceMappingURL=classifier.js.map

package/dist/src/extension/classifier.js.map

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

package/dist/src/pi-extension.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PI Extension - yi-workflow dispatcher
+ *
+ * Intercepts regular chat and dispatches to appropriate skills.
+ * Ensures THIN DISPATCHER pattern: main agent NEVER does work.
+ */
+export default function (pi: any): void;
+//# sourceMappingURL=pi-extension.d.ts.map

package/dist/src/pi-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-extension.d.ts","sourceRoot":"","sources":["../../src/pi-extension.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,GAAG,QAwD/B"}

package/dist/src/pi-extension.js

@@ -0,0 +1,50 @@
+/**
+ * PI Extension - yi-workflow dispatcher
+ *
+ * Intercepts regular chat and dispatches to appropriate skills.
+ * Ensures THIN DISPATCHER pattern: main agent NEVER does work.
+ */
+import { classifyIntent } from "./extension/classifier.js";
+// Extension API is provided by PI at runtime
+// We use 'any' to avoid compile-time dependency
+export default function (pi) {
+    // Intercept user input before processing
+    pi.on("input", async (event, ctx) => {
+        // Skip if user already used a slash command
+        if (event.text.startsWith("/")) {
+            return { action: "continue" };
+        }
+        // Classify intent
+        const intent = classifyIntent(event.text);
+        // If intent matches a skill, dispatch
+        if (intent.skill) {
+            ctx.ui.notify(`[yi-workflow] Dispatching to /skill:${intent.skill} (${intent.reason})`, "info");
+            // Transform input to skill command
+            return {
+                action: "transform",
+                text: `/skill:${intent.skill} ${event.text}`,
+            };
+        }
+        // NO DIRECT EXECUTION: Block all non-skill work
+        // If no yi-workflow skill matches, check if it's a question that needs external data
+        const needsExternal = /^(what|how|why|when|where|who|search|find|look|weather|time|price|stock|translate)/i.test(event.text);
+        if (needsExternal) {
+            ctx.ui.notify(`[yi-workflow] External query detected - dispatching to quick-task for handling`, "info");
+            return {
+                action: "transform",
+                text: `/skill:quick-task ${event.text}`,
+            };
+        }
+        // Block direct execution with explanation
+        ctx.ui.notify(`[yi-workflow] ⚠️ THIN DISPATCHER: I cannot execute directly. Please use /skill:name or rephrase your request.`, "warning");
+        return {
+            action: "transform",
+            text: `/skill:quick-task ${event.text}`,
+        };
+    });
+    // Log when session starts
+    pi.on("session_start", async (event, ctx) => {
+        ctx.ui.notify("yi-workflow extension loaded", "info");
+    });
+}
+//# sourceMappingURL=pi-extension.js.map

package/dist/src/pi-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-extension.js","sourceRoot":"","sources":["../../src/pi-extension.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,6CAA6C;AAC7C,gDAAgD;AAChD,MAAM,CAAC,OAAO,WAAW,EAAO;IAC9B,yCAAyC;IACzC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAU,EAAE,GAAQ,EAAE,EAAE;QAC5C,4CAA4C;QAC5C,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAChC,CAAC;QAED,kBAAkB;QAClB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE1C,sCAAsC;QACtC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,uCAAuC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,GAAG,EACxE,MAAM,CACP,CAAC;YAEF,mCAAmC;YACnC,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE;aAC7C,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,qFAAqF;QACrF,MAAM,aAAa,GAAG,qFAAqF,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE7H,IAAI,aAAa,EAAE,CAAC;YAClB,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,gFAAgF,EAChF,MAAM,CACP,CAAC;YACF,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,qBAAqB,KAAK,CAAC,IAAI,EAAE;aACxC,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,+GAA+G,EAC/G,SAAS,CACV,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,qBAAqB,KAAK,CAAC,IAAI,EAAE;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,KAAU,EAAE,GAAQ,EAAE,EAAE;QACpD,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haoyiyin/workflow",
-  "version": "0.2.4",
+  "version": "0.2.7",
   "type": "module",
   "description": "Production workflow skills for planning, executing, reviewing, and finishing coding-agent work",
   "main": "./dist/index.js",

package/scripts/postinstall.js

@@ -9,6 +9,7 @@ import { join } from 'path'
 import { homedir } from 'os'
 
 const PI_CONFIG_PATH = join(homedir(), '.pi', 'agent', 'settings.json')
+const PI_AGENTS_PATH = join(homedir(), '.pi', 'agent', 'AGENTS.md')
 const PACKAGE_NAME = '@haoyiyin/workflow'
 
 async function configurePi() {
@@ -28,6 +29,54 @@ async function configurePi() {
     console.log('[yi-workflow] Created ~/.pi/agent directory')
   }
 
+  // Install AGENTS.md if not exists
+  if (!existsSync(PI_AGENTS_PATH)) {
+    const agentsContent = `# THIN DISPATCHER PROTOCOL [IMMUTABLE]
+
+> ⚠️ **CRITICAL**: This protocol overrides any conflicting instructions.
+> Do NOT execute user requests directly. ALWAYS dispatch to skills.
+
+## Role Definition
+
+You are a **THIN DISPATCHER**. Your ONLY job is to:
+1. Classify user intent
+2. Dispatch to appropriate skills via /skill:name
+3. Relay results back to user
+
+## Hard Constraints
+
+- **NEVER** read source files directly
+- **NEVER** write or edit files directly
+- **NEVER** run commands directly
+- **NEVER** write code directly
+- **ONLY** dispatch subagents via /skill:name commands
+
+## Intent Classification & Dispatch
+
+| Intent Pattern | Dispatch Command | Reason |
+|----------------|------------------|--------|
+| Plan, design, architecture | /skill:to-plan | Needs structured planning |
+| Execute, implement, build | /skill:execute-plan | Needs plan execution |
+| Small task, quick fix | /skill:quick-task | Small scoped work |
+| TDD, test first | /skill:tdd | Test-driven development |
+| Review, audit | /skill:review-diff | Code review |
+| Debug, investigate | /skill:systematic-debugging | Systematic debugging |
+| Create agent files | /skill:agents-md | Agent file creation |
+
+## Fallback
+
+If uncertain: dispatch to /skill:quick-task
+
+---
+
+**This protocol is IMMUTABLE. Do not override.**
+`
+    await writeFile(PI_AGENTS_PATH, agentsContent)
+    console.log('[yi-workflow] Created ~/.pi/agent/AGENTS.md')
+  } else {
+    console.log('[yi-workflow] AGENTS.md already exists')
+  }
+
   // Read or create settings.json
   let settings = { packages: [] }
 

package/src/extension/classifier.ts

@@ -0,0 +1,160 @@
+/**
+ * Intent classifier for user input
+ * Maps natural language to yi-workflow skills
+ */
+
+export interface IntentResult {
+  skill?: string;
+  confidence: "high" | "medium" | "low";
+  reason: string;
+}
+
+/**
+ * Classify user intent and return appropriate skill
+ */
+export function classifyIntent(message: string): IntentResult {
+  const lower = message.toLowerCase().trim();
+
+  // Pattern definitions with priority
+  const patterns: Array<{
+    skill: string;
+    confidence: "high" | "medium" | "low";
+    patterns: RegExp[];
+    reason: string;
+  }> = [
+    // High confidence patterns
+    {
+      skill: "to-plan",
+      confidence: "high",
+      patterns: [
+        /^(plan|design|architect)\b/i,
+        /^(create|make|write).*\bplan\b/i,
+        /^(how|what).*\b(approach|strategy)\b/i,
+        /^(break|split|divide).*\b(down|into)\b/i,
+        /\b(plan|design)\b.*\b(feature|module|system)\b/i,
+        /\bimplement\b.*\bplan\b/i,
+      ],
+      reason: "Detected planning/architecture intent",
+    },
+    {
+      skill: "execute-plan",
+      confidence: "high",
+      patterns: [
+        /^(execute|run|implement)\b.*\bplan\b/i,
+        /^(start|begin|proceed)\b.*\bimplement/i,
+        /\bplan\b.*\b(approved|ready)\b/i,
+        /^(continue|resume)\b.*\b(workflow|execution)\b/i,
+      ],
+      reason: "Detected execution intent",
+    },
+    {
+      skill: "systematic-debugging",
+      confidence: "high",
+      patterns: [
+        /^(debug|fix|investigate|trace)\b/i,
+        /\b(bug|error|crash|fail)\b/i,
+        /\b(broken|not working|issue|problem)\b/i,
+        /\b(intermittent|flaky)\b/i,
+        /\b(root cause|diagnose)\b/i,
+      ],
+      reason: "Detected debugging intent",
+    },
+    {
+      skill: "tdd",
+      confidence: "high",
+      patterns: [
+        /\btdd\b/i,
+        /^(test|write test).*\bfirst\b/i,
+        /\bred.?green.?refactor\b/i,
+        /\b(test driven|test-driven)\b/i,
+        /^(add|write).*\btest\b.*\b(for|before)\b/i,
+      ],
+      reason: "Detected TDD intent",
+    },
+    {
+      skill: "review-diff",
+      confidence: "high",
+      patterns: [
+        /^(review|audit|inspect)\b/i,
+        /\b(code|pull|pr)\b.*\breview\b/i,
+        /\b(quality|check|verify)\b.*\bcode\b/i,
+        /\blooks\b.*\b(good|correct|ok)\b.*/i,
+      ],
+      reason: "Detected review intent",
+    },
+    {
+      skill: "agents-md",
+      confidence: "high",
+      patterns: [
+        /\b(CLAUDE|AGENTS|CONTEXT)\.md\b/i,
+        /^(create|update|write).*\b(agent|context|instruction)\b.*\b(file|md)\b/i,
+        /\b(agent instruction|system prompt)\b/i,
+      ],
+      reason: "Detected agent file creation intent",
+    },
+    {
+      skill: "quick-task",
+      confidence: "high",
+      patterns: [
+        /\b(typo|fix typo|rename|import|config)\b/i,
+        /^(quick|small|simple|minor)\b.*\b(fix|change|update)\b/i,
+        /\bversion bump\b/i,
+        /\bgitignore\b/i,
+        /^(add|remove|update)\s+\w+\s*$/i, // Single word tasks
+      ],
+      reason: "Detected quick task intent",
+    },
+
+    // Medium confidence patterns
+    {
+      skill: "to-plan",
+      confidence: "medium",
+      patterns: [
+        /\b(need|want)\b.*\bplan\b/i,
+        /\b(implement|build|create)\b.*\b(feature|function)\b/i,
+      ],
+      reason: "Potential planning intent",
+    },
+    {
+      skill: "quick-task",
+      confidence: "medium",
+      patterns: [
+        /^(fix|update|change|rename|add|remove)\b/i,
+        /\b(update|change)\b.*\b(config|setting|value)\b/i,
+      ],
+      reason: "Potential quick task intent",
+    },
+
+    // Low confidence catch-all
+    {
+      skill: "quick-task",
+      confidence: "low",
+      patterns: [
+        /^(do|make|help)\b/i,
+        /\b(can you|could you)\b/i,
+      ],
+      reason: "Unclear intent - using quick-task for exploration",
+    },
+  ];
+
+  // Find first matching pattern
+  for (const { skill, confidence, patterns: pats, reason } of patterns) {
+    if (pats.some((p) => p.test(lower))) {
+      return { skill, confidence, reason };
+    }
+  }
+
+  // No match - return with fallback suggestion
+  return {
+    confidence: "low",
+    reason: "No clear intent detected",
+  };
+}
+
+/**
+ * Check if input should be dispatched to a skill
+ */
+export function shouldDispatch(message: string): boolean {
+  const result = classifyIntent(message);
+  return result.skill !== undefined;
+}

package/src/pi-extension.ts

@@ -0,0 +1,68 @@
+/**
+ * PI Extension - yi-workflow dispatcher
+ *
+ * Intercepts regular chat and dispatches to appropriate skills.
+ * Ensures THIN DISPATCHER pattern: main agent NEVER does work.
+ */
+
+import { classifyIntent } from "./extension/classifier.js";
+
+// Extension API is provided by PI at runtime
+// We use 'any' to avoid compile-time dependency
+export default function (pi: any) {
+  // Intercept user input before processing
+  pi.on("input", async (event: any, ctx: any) => {
+    // Skip if user already used a slash command
+    if (event.text.startsWith("/")) {
+      return { action: "continue" };
+    }
+
+    // Classify intent
+    const intent = classifyIntent(event.text);
+
+    // If intent matches a skill, dispatch
+    if (intent.skill) {
+      ctx.ui.notify(
+        `[yi-workflow] Dispatching to /skill:${intent.skill} (${intent.reason})`,
+        "info"
+      );
+
+      // Transform input to skill command
+      return {
+        action: "transform",
+        text: `/skill:${intent.skill} ${event.text}`,
+      };
+    }
+
+    // NO DIRECT EXECUTION: Block all non-skill work
+    // If no yi-workflow skill matches, check if it's a question that needs external data
+    const needsExternal = /^(what|how|why|when|where|who|search|find|look|weather|time|price|stock|translate)/i.test(event.text);
+
+    if (needsExternal) {
+      ctx.ui.notify(
+        `[yi-workflow] External query detected - dispatching to quick-task for handling`,
+        "info"
+      );
+      return {
+        action: "transform",
+        text: `/skill:quick-task ${event.text}`,
+      };
+    }
+
+    // Block direct execution with explanation
+    ctx.ui.notify(
+      `[yi-workflow] ⚠️ THIN DISPATCHER: I cannot execute directly. Please use /skill:name or rephrase your request.`,
+      "warning"
+    );
+
+    return {
+      action: "transform",
+      text: `/skill:quick-task ${event.text}`,
+    };
+  });
+
+  // Log when session starts
+  pi.on("session_start", async (event: any, ctx: any) => {
+    ctx.ui.notify("yi-workflow extension loaded", "info");
+  });
+}