@codeharbor/agent-playbook 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeharbor/agent-playbook",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Local skill manager and installer for agent-playbook across Claude Code, Codex, and Gemini.",
   "license": "MIT",
   "type": "commonjs",

package/skills/create-pr/SKILL.md

@@ -58,11 +58,11 @@ git diff --name-only main..HEAD | grep "^skills/"
 
 ### Auto-Trigger Changes Require Update
 
-If a skill's `hooks:` front matter was modified, the **Auto-Trigger** column in the Skills Catalog must be updated:
+If a skill's `metadata.hooks` front matter was modified, the **Auto-Trigger** column in the Skills Catalog must be updated:
 
 ```bash
 # Check if hooks were modified
-git diff main..HEAD -- skills/*/SKILL.md | grep -E "^\+.*hooks:|^\+.*trigger:"
+git diff main..HEAD -- skills/*/SKILL.md | grep -E "^\+.*metadata:|^\+.*hooks:|^\+.*trigger:"
 ```
 
 If hooks changed → Update README.md and README.zh-CN.md Auto-Trigger column.

package/skills/figma-designer/SKILL.md

@@ -2,18 +2,19 @@
 name: figma-designer
 description: Analyzes Figma designs and generates implementation-ready PRDs with detailed visual specifications. Use when user provides Figma link or uploads design screenshots. Requires Figma MCP server connection.
 allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, AskUserQuestion
-hooks:
-  after_complete:
-    - trigger: prd-planner
-      mode: ask_first
-      condition: prd_generated
-      reason: "Further refine PRD with 4-file pattern"
-    - trigger: self-improving-agent
-      mode: background
-      reason: "Learn design patterns for future reference"
-    - trigger: session-logger
-      mode: auto
-      reason: "Save design analysis session"
+metadata:
+  hooks:
+    after_complete:
+      - trigger: prd-planner
+        mode: ask_first
+        condition: prd_generated
+        reason: "Further refine PRD with 4-file pattern"
+      - trigger: self-improving-agent
+        mode: background
+        reason: "Learn design patterns for future reference"
+      - trigger: session-logger
+        mode: auto
+        reason: "Save design analysis session"
 ---
 
 # Figma Designer

package/skills/prd-planner/SKILL.md

@@ -2,14 +2,15 @@
 name: prd-planner
 description: Creates PRDs using persistent file-based planning. Use when user explicitly says "PRD", "product requirements document", or "产品需求文档". Combines PRD methodology with planning-with-files to avoid context switching.
 allowed-tools: Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion, WebSearch
-hooks:
-  after_complete:
-    - trigger: self-improving-agent
-      mode: background
-      reason: "Extract patterns and improve PRD quality"
-    - trigger: session-logger
-      mode: auto
-      reason: "Save session context"
+metadata:
+  hooks:
+    after_complete:
+      - trigger: self-improving-agent
+        mode: background
+        reason: "Extract patterns and improve PRD quality"
+      - trigger: session-logger
+        mode: auto
+        reason: "Save session context"
 ---
 
 # PRD Planner

package/skills/self-improving-agent/SKILL.md

@@ -2,25 +2,26 @@
 name: self-improving-agent
 description: A universal self-improving agent that learns from ALL skill experiences. Uses multi-memory architecture (semantic + episodic + working) to continuously evolve the codebase. Auto-triggers on skill completion/error with hooks-based self-correction.
 allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
-hooks:
-  before_start:
-    - trigger: session-logger
-      mode: auto
-      context: "Start {skill_name}"
-  after_complete:
-    - trigger: create-pr
-      mode: ask_first
-      condition: skills_modified
-      reason: "Submit improvements to repository"
-    - trigger: session-logger
-      mode: auto
-      context: "Self-improvement cycle complete"
-  # Note: on_error intentionally only logs to session to avoid infinite recursion
-  # Self-correction is triggered by other skills (debugger, code-reviewer) completing their work
-  on_error:
-    - trigger: session-logger
-      mode: auto
-      context: "Error captured in {skill_name}"
+metadata:
+  hooks:
+    before_start:
+      - trigger: session-logger
+        mode: auto
+        context: "Start {skill_name}"
+    after_complete:
+      - trigger: create-pr
+        mode: ask_first
+        condition: skills_modified
+        reason: "Submit improvements to repository"
+      - trigger: session-logger
+        mode: auto
+        context: "Self-improvement cycle complete"
+    # Note: on_error intentionally only logs to session to avoid infinite recursion
+    # Self-correction is triggered by other skills (debugger, code-reviewer) completing their work
+    on_error:
+      - trigger: session-logger
+        mode: auto
+        context: "Error captured in {skill_name}"
 ---
 
 # Self-Improving Agent

package/skills/workflow-orchestrator/SKILL.md

@@ -2,11 +2,12 @@
 name: workflow-orchestrator
 description: Automatically coordinates multi-skill workflows and triggers follow-up actions. Use when completing PRD creation, implementation, or any milestone that should trigger additional skills. This skill reads the auto-trigger configuration and executes the workflow chain.
 allowed-tools: Read, Write, Edit, Bash, Grep, AskUserQuestion
-hooks:
-  after_complete:
-    - trigger: session-logger
-      mode: auto
-      reason: "Save workflow execution context"
+metadata:
+  hooks:
+    after_complete:
+      - trigger: session-logger
+        mode: auto
+        reason: "Save workflow execution context"
 ---
 
 # Workflow Orchestrator

package/src/cli.js

@@ -1755,6 +1755,9 @@ function updateClaudeSettings(settings, cliPath, options) {
   const data = existing || {};
 
   data.hooks = data.hooks || {};
+  const marker = `--hook-source ${HOOK_SOURCE_VALUE}`;
+  data.hooks = removeHookCommand(data.hooks, "SessionEnd", marker);
+  data.hooks = removeHookCommand(data.hooks, "PostToolUse", marker);
 
   let sessionCommand = buildHookCommand(cliPath, "session-log");
   sessionCommand = `${sessionCommand} --hook-source ${HOOK_SOURCE_VALUE}`;
@@ -1891,8 +1894,11 @@ function upsertCodexBlock(content, values) {
 }
 
 function removeCodexBlock(content) {
-  const pattern = /^\[agent_playbook\][\s\S]*?(?=^\[|\s*$)/m;
-  return content.replace(pattern, "").trimEnd();
+  const pattern = /^\[agent_playbook\][\s\S]*?(?=^\[|\s*$)/gm;
+  const cleaned = content.replace(pattern, "");
+  const legacyPattern =
+    /(?:\n\s*version\s*=\s*\"[^\"]*\"\s*\n\s*installed_at\s*=\s*\"[^\"]*\"\s*)+$/;
+  return cleaned.replace(legacyPattern, "\n").trimEnd();
 }
 
 function buildHookCommand(cliPath, subcommand) {