feat: integrate skills into Playbook — tag-based knowledge injection

Replace hardcoded skills/index.ts with Playbook-based skill rules.
Skills are now category="skill" playbook rules with tags, injected
only when task labels match rule tags (pinpoint injection).

- fetchPlaybookPrompt now accepts taskTags parameter
- All 3 skill injection points (spawn_reviewer, review_changes,
  toban review) use Playbook API instead of hardcoded getSkillKnowledge
- Task labels are extracted and passed as tags for matching

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: recuu-pfeg

src/agent-templates.ts

@@ -670,16 +670,15 @@ export async function executeActions(
           const { PROMPT_TEMPLATES } = await import("./prompts/templates.js");
           const typeHints = JSON.parse(PROMPT_TEMPLATES["reviewer-type-hints"] || "{}") as Record<string, string>;
 
+          // Fetch playbook rules for reviewer, including skill rules matching task labels
           let customRules = "";
-          try { customRules = await ctx.api.fetchPlaybookPrompt("reviewer") || ""; } catch { /* non-fatal */ }
-
-          // Inject skills knowledge if task has skills defined
-          const taskSkills = (ctx.task as Record<string, unknown>).skills as string[] | null;
-          if (taskSkills && taskSkills.length > 0) {
-            const { getSkillKnowledge } = await import("./prompts/skills/index.js");
-            const skillRules = getSkillKnowledge(taskSkills);
-            if (skillRules) customRules += "\n\n" + skillRules;
-          }
+          const taskLabels: string[] = (() => {
+            const raw = (ctx.task as Record<string, unknown>).labels;
+            if (Array.isArray(raw)) return raw;
+            if (typeof raw === "string") { try { return JSON.parse(raw); } catch { return []; } }
+            return [];
+          })();
+          try { customRules = await ctx.api.fetchPlaybookPrompt("reviewer", taskLabels) || ""; } catch { /* non-fatal */ }
 
           const reviewerTemplate = DEFAULT_TEMPLATES.find((t) => t.id === "reviewer")!;
           const reviewCriteria = [
@@ -851,13 +850,14 @@ export async function executeActions(
                 taskDescription: ctx.task.description || "(no description)",
                 taskTypeHint: typeHints[taskType] || typeHints.implementation || "",
                 customReviewRules: await (async () => {
+                  const labels: string[] = (() => {
+                    const raw = (ctx.task as Record<string, unknown>).labels;
+                    if (Array.isArray(raw)) return raw;
+                    if (typeof raw === "string") { try { return JSON.parse(raw); } catch { return []; } }
+                    return [];
+                  })();
                   let rules = "";
-                  try { rules = await ctx.api.fetchPlaybookPrompt("reviewer") || ""; } catch { /* */ }
-                  const taskSkills = (ctx.task as Record<string, unknown>).skills as string[] | null;
-                  if (taskSkills?.length) {
-                    const { getSkillKnowledge } = await import("./prompts/skills/index.js");
-                    rules += "\n\n" + getSkillKnowledge(taskSkills);
-                  }
+                  try { rules = await ctx.api.fetchPlaybookPrompt("reviewer", labels) || ""; } catch { /* */ }
                   return rules ? `\n## Project-Specific Review Rules\n${rules}` : "";
                 })()
               });

src/api-client.ts

@@ -94,7 +94,7 @@ export interface ApiClient {
   }): Promise<void>;
   submitRetroComment(sprintNumber: number, data: RetroCommentInput): Promise<void>;
   reportProgress(data: ProgressReport): Promise<void>;
-  fetchPlaybookPrompt(agentName?: string): Promise<string>;
+  fetchPlaybookPrompt(agentName?: string, taskTags?: string[]): Promise<string>;
   fetchMessages(channel: string): Promise<Message[]>;
   sendMessage(from: string, to: string, content: string): Promise<void>;
   fetchMySecrets(): Promise<Record<string, string>>;
@@ -265,9 +265,12 @@ export function createApiClient(apiUrl: string, apiKey: string): ApiClient {
       }
     },
 
-    async fetchPlaybookPrompt(agentName?: string): Promise<string> {
+    async fetchPlaybookPrompt(agentName?: string, taskTags?: string[]): Promise<string> {
       try {
-        const qs = agentName ? `?agent=${encodeURIComponent(agentName)}` : "";
+        const params = new URLSearchParams();
+        if (agentName) params.set("agent", agentName);
+        if (taskTags?.length) params.set("tags", taskTags.join(","));
+        const qs = params.toString() ? `?${params.toString()}` : "";
         const res = await fetch(`${apiUrl}/api/v1/playbook/prompt${qs}`, { headers });
         if (!res.ok) return "";
         const data = (await res.json()) as { prompt: string };

src/cli.ts

@@ -265,6 +265,8 @@ async function runLoop(cliArgs: CliArgs, runner: AgentRunner): Promise<void> {
       const agentName = task.owner ?? "builder";
       const apiDocs = await api.fetchApiDocs(agentName);
       const taskType = (task as Record<string, unknown>).type as string | undefined;
+      const rawLabels = (task as Record<string, unknown>).labels;
+      const taskLabels: string[] = Array.isArray(rawLabels) ? rawLabels : typeof rawLabels === "string" ? (() => { try { return JSON.parse(rawLabels); } catch { return []; } })() : [];
       const agentTemplate = matchTemplate(taskType, agentName);
       const isReadOnly = agentTemplate.tools !== "all";
       ui.info(`[task] Template: "${agentTemplate.id}"${isReadOnly ? ` (read-only: ${(agentTemplate.tools as string[]).join(", ")})` : ""}`);
@@ -344,7 +346,7 @@ async function runLoop(cliArgs: CliArgs, runner: AgentRunner): Promise<void> {
         taskPriority: typeof task.priority === "string" ? task.priority : `p${task.priority}`,
         taskType, apiUrl: cliArgs.apiUrl, apiKey: cliArgs.apiKey,
         language: ctx.language,
-        playbookRules: (await ctx.api.fetchPlaybookPrompt(agentName)) || ctx.playbookRules,
+        playbookRules: (await ctx.api.fetchPlaybookPrompt(agentName, taskLabels)) || ctx.playbookRules,
         targetRepo: task.target_repo ?? undefined,
         apiDocs: apiDocs || undefined, engineHint: getEngine(cliArgs.engine).promptHint,
         pastFailures: pastFailures.length > 0 ? pastFailures : undefined,
@@ -753,15 +755,17 @@ async function handleReview(apiUrl: string, apiKey: string, taskId?: string, ski
   const taskType = (task as Record<string, unknown>).type as string || "implementation";
   const typeHints = JSON.parse(PROMPT_TEMPLATES["reviewer-type-hints"] || "{}") as Record<string, string>;
 
+  // Fetch playbook rules including skill rules matching task labels or --skill args
+  const reviewTags = skills || (() => {
+    const raw = (task as Record<string, unknown>).labels;
+    if (Array.isArray(raw)) return raw as string[];
+    if (typeof raw === "string") { try { return JSON.parse(raw) as string[]; } catch { return []; } }
+    return [];
+  })();
   let customRules = "";
-  try { customRules = await api.fetchPlaybookPrompt("reviewer") || ""; } catch { /* non-fatal */ }
-
-  // Inject skills knowledge
-  const activeSkills = skills || (task as Record<string, unknown>).skills as string[] | null || [];
-  if (activeSkills.length > 0) {
-    const { getSkillKnowledge } = await import("./prompts/skills/index.js");
-    customRules += "\n\n" + getSkillKnowledge(activeSkills);
-    ui.info(`[review] Skills injected: ${activeSkills.join(", ")}`);
+  try { customRules = await api.fetchPlaybookPrompt("reviewer", reviewTags) || ""; } catch { /* non-fatal */ }
+  if (reviewTags.length > 0) {
+    ui.info(`[review] Tags for skill matching: ${reviewTags.join(", ")}`);
   }
 
   const reviewSystem = interpolate(PROMPT_TEMPLATES["reviewer-system"] || "", {