@boyingliu01/xp-gate 0.8.2 → 0.8.5

package/lib/uninstall.js

@@ -260,6 +260,68 @@ function buildPlan(mode) {
   return plan;
 }
 
+/**
+ * Remove a single file item with ownership verification.
+ * @returns {boolean} true on success, false on skip (not xp-gate owned)
+ */
+function removeFile(item, config) {
+  const manifestEntry = config.manifest && config.manifest.files
+    ? config.manifest.files[item.manifestKey]
+    : null;
+
+  if (!verifyFileOwnership(item.path, manifestEntry, item.signature)) {
+    if (fs.existsSync(item.path)) {
+      console.warn(`  Warning: ${item.label} does not contain xp-gate signature — skipping`);
+    }
+    return false;
+  }
+
+  fs.unlinkSync(item.path);
+  console.log(`  Removed ${item.label}`);
+  return true;
+}
+
+/**
+ * Remove a directory item.
+ * @returns {boolean} true if dir existed and was removed, false otherwise
+ */
+function removeDir(item) {
+  if (!fs.existsSync(item.path)) return false;
+  fs.rmSync(item.path, { recursive: true, force: true });
+  console.log(`  Removed ${item.label}`);
+  return true;
+}
+
+/**
+ * Unset core.hooksPath if it matches the expected xp-gate path.
+ * @returns {boolean} true if unset was performed or already unset, false on mismatch
+ */
+function unsetGitConfigIfMatch(item) {
+  const currentPath = getCurrentHooksPath();
+  if (currentPath === null || currentPath === '') {
+    console.log(`  ${item.label} — not set`);
+    return true;
+  }
+  if (currentPath === item.expectedPath) {
+    unsetHooksPath();
+    console.log(`  Unset ${item.label}`);
+    return true;
+  }
+  console.warn(`  Warning: core.hooksPath (${currentPath}) does not match xp-gate path — skipping unset`);
+  return false;
+}
+
+/**
+ * Execute a single plan item (file/dir/gitconfig).
+ * @returns {boolean} true on success, false on skip/failure
+ */
+function executePlanItem(item, config) {
+  if (item.type === 'file') return removeFile(item, config);
+  if (item.type === 'dir') return removeDir(item);
+  if (item.type === 'gitconfig' && item.action === 'unset-hooks-path') return unsetGitConfigIfMatch(item);
+  return false;
+}
+
 /**
  * @param {string[]} args CLI arguments
  * @returns {number} exit code (0 = success, 1 = error)
@@ -337,37 +399,7 @@ async function uninstall(args) {
 
   for (const item of plan) {
     try {
-      if (item.type === 'file') {
-        const manifestEntry = config.manifest && config.manifest.files
-          ? config.manifest.files[item.manifestKey]
-          : null;
-
-        if (!verifyFileOwnership(item.path, manifestEntry, item.signature)) {
-          if (fs.existsSync(item.path)) {
-            console.warn(`  Warning: ${item.label} does not contain xp-gate signature — skipping`);
-          }
-          continue;
-        }
-
-        fs.unlinkSync(item.path);
-        console.log(`  Removed ${item.label}`);
-      } else if (item.type === 'dir') {
-        if (fs.existsSync(item.path)) {
-          fs.rmSync(item.path, { recursive: true, force: true });
-          console.log(`  Removed ${item.label}`);
-        }
-      } else if (item.type === 'gitconfig' && item.action === 'unset-hooks-path') {
-        const currentPath = getCurrentHooksPath();
-        if (currentPath === null || currentPath === '') {
-          // Already unset
-          console.log(`  ${item.label} — not set`);
-        } else if (currentPath === item.expectedPath) {
-          unsetHooksPath();
-          console.log(`  Unset ${item.label}`);
-        } else {
-          console.warn(`  Warning: core.hooksPath (${currentPath}) does not match xp-gate path — skipping unset`);
-        }
-      }
+      hadErrors = !executePlanItem(item, config) || hadErrors;
     } catch (e) {
       console.warn(`  Warning: Could not remove ${item.label}: ${e.message}`);
       hadErrors = true;

package/lib/update-skill.js

@@ -8,57 +8,55 @@ const HOME = process.env.HOME || process.env.USERPROFILE || os.homedir();
 const CONFIG_DIR = path.join(HOME, '.config', 'xp-gate');
 const SKILLS_DIR = path.join(HOME, '.config', 'opencode', 'skills');
 
-async function updateSkill(name, options = {}) {
-  const { all = false, check = false, verbose = false } = options;
-  
-  if (check) {
-    console.log('Checking for updates...');
-    const config = getConfig();
-    const skills = config.installedSkills || {};
-    
-    for (const [skillName, info] of Object.entries(skills)) {
-      console.log(`  ${skillName}: ${info.version || 'unknown'}`);
-    }
-    console.log('Update check complete');
-    return 0;
+function handleCheckMode() {
+  console.log('Checking for updates...');
+  const config = getConfig();
+  const skills = config.installedSkills || {};
+  for (const [skillName, info] of Object.entries(skills)) {
+    console.log(`  ${skillName}: ${info.version || 'unknown'}`);
   }
-  
-  if (all) {
-    const config = getConfig();
-    const skills = config.installedSkills || {};
-    
-    console.log('Updating all skills...');
-    let hasErrors = false;
-    
-    for (const skillName of Object.keys(skills)) {
-      try {
-        await updateSingleSkill(skillName, verbose);
-      } catch (err) {
-        console.error(`Failed to update ${skillName}: ${err.message}`);
-        hasErrors = true;
-      }
+  console.log('Update check complete');
+  return 0;
+}
+
+async function handleAllMode(verbose) {
+  const config = getConfig();
+  const skills = config.installedSkills || {};
+  console.log('Updating all skills...');
+  let hasErrors = false;
+  for (const skillName of Object.keys(skills)) {
+    try {
+      await updateSingleSkill(skillName, verbose);
+    } catch (err) {
+      console.error(`Failed to update ${skillName}: ${err.message}`);
+      hasErrors = true;
     }
-    
-    return hasErrors ? 1 : 0;
   }
-  
+  return hasErrors ? 1 : 0;
+}
+
+function handleSingleMode(name, verbose) {
   if (!name) {
     console.error('Error: Skill name required');
     console.error('Usage: xp-gate update-skill <name> or --all');
     return 1;
   }
-  
   const config = getConfig();
   const skills = config.installedSkills || {};
-  
   if (!skills[name]) {
     console.error(`Error: ${name} is not installed`);
     return 1;
   }
-  
   return updateSingleSkill(name, verbose);
 }
 
+async function updateSkill(name, options = {}) {
+  const { all = false, check = false, verbose = false } = options;
+  if (check) return handleCheckMode();
+  if (all) return handleAllMode(verbose);
+  return handleSingleMode(name, verbose);
+}
+
 async function updateSingleSkill(name, verbose) {
   console.log(`Updating ${name}...`);
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.8.2",
+  "version": "0.8.5",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"

package/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.8.2",
+  "version": "0.8.5",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 6 quality gates, Sprint Flow, and Delphi multi-expert review.",
   "author": {

package/plugins/claude-code/skills/sprint-flow/SKILL.md

@@ -12,6 +12,7 @@ description: >
   - "start sprint"
   - "一键开发"
   - "/sprint-flow"
+  触发后第一行输出: `Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP`
   用法: /sprint-flow "[需求描述]"
   示例: /sprint-flow "开发访谈机器人，支持多轮对话"
   可选参数:
@@ -236,6 +237,36 @@ ISOLATE → AUTO-ESTIMATE → THINK → PLAN → [GITHOOKS-GATE] → BUILD → R
 
 ## 各 Phase 调用的 Skills
 
+### ⚠️ 强制输出格式规范（Mandatory Output Format）
+
+**执行每个 Phase 时，必须以以下固定格式输出阶段标题**，不可省略、不可合并、不可替换：
+
+```markdown
+## Phase -1: ISOLATE (隔离)
+## Phase -0.5: AUTO-ESTIMATE (规模评估)
+## Phase 0: THINK (思考)
+## Phase 1: PLAN (规划)
+## Phase 2: BUILD (构建)
+## Phase 3: REVIEW (评审)
+## Phase 4: USER ACCEPTANCE (用户验收)
+## Phase 5: FEEDBACK (反馈)
+## Phase 6: SHIP (发布)
+## Phase 7: LAND (部署)
+## Phase 8: CLEANUP (清理)
+```
+
+**规则**：
+1. 每个 Phase **开始执行时必须首先输出**对应的 `## Phase X: NAME` 标题行（作为该 Phase 输出的第一行）
+2. **禁止省略** "Phase" 关键词（如不能只写 "ISOLATE" 或 "## -1"）
+3. **禁止合并**多个 Phase 的输出（每个 Phase 必须有独立标题）
+4. **格式必须精确匹配**：`## Phase ` + 数字 + `: ` + 大写英文名 + ` (中文名)`
+5. 跳过某个 Phase（如 `--resume-from build` 跳过了 -1, -0.5, 0, 1）时，不输出被跳过 Phase 的标题
+6. 触发 `/sprint-flow` 后，**第一行输出应包含工作流阶段概览**：
+
+```
+Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP
+```
+
 ### Phase -1: ISOLATE（git worktree 隔离）
 
 **执行时机**: `/sprint-flow` 启动后、Phase 0 THINK 之前。**自动执行**。

package/plugins/opencode/README.md

@@ -14,7 +14,7 @@ In your `opencode.json`:
 
 ```json
 {
-  "plugin": ["@xp-gate/opencode-plugin"]
+  "plugin": ["@boyingliu01/opencode-plugin"]
 }
 ```
 

package/plugins/opencode/package.json

@@ -1,12 +1,26 @@
 {
-  "name": "@xp-gate/opencode-plugin",
-  "version": "0.8.2",
-  "private": true,
+  "name": "@boyingliu01/opencode-plugin",
+  "version": "0.8.5",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills for OpenCode",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/boyingliu01/xp-gate",
+    "directory": "plugins/opencode"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "index.ts",
+    "skills/",
+    "tsconfig.json",
+    "README.md"
+  ],
   "scripts": {
-    "build": "bun build index.ts --outdir dist --target bun",
+    "prepack": "node scripts/prepack.cjs",
     "check": "tsc --noEmit"
   },
   "dependencies": {
@@ -14,5 +28,15 @@
   },
   "devDependencies": {
     "typescript": "^5.4.0"
-  }
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "xp-gate",
+    "quality-gates",
+    "code-review",
+    "sprint-flow"
+  ],
+  "author": "boyingliu01",
+  "license": "MIT"
 }

package/plugins/opencode/scripts/prepack.cjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * prepack.js — Bundle skills into @boyingliu01/opencode-plugin before npm publish.
+ *
+ * Skills live in repo-root `skills/` and are gitignored in `plugins/opencode/skills/`.
+ * This script copies them into the plugin package so the published tarball is self-contained.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PLUGIN_ROOT = path.resolve(__dirname, '..');
+const REPO_ROOT = path.resolve(PLUGIN_ROOT, '..', '..');
+
+const CORE_SKILLS = [
+  'admin-template-guidelines',
+  'delphi-review',
+  'improve-codebase-architecture',
+  'ralph-loop',
+  'sprint-flow',
+  'test-driven-development',
+  'test-specification-alignment',
+  'to-issues',
+];
+
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'coverage', '.opencode']);
+const SKIP_FILES = new Set(['package-lock.json']);
+const SKIP_FILE_SUFFIXES = ['.lock', '.js.map'];
+
+function shouldSkipFile(name) {
+  if (SKIP_FILES.has(name)) return true;
+  return SKIP_FILE_SUFFIXES.some(suffix => name.endsWith(suffix));
+}
+
+function copyDir(src, dest) {
+  if (!fs.existsSync(src)) {
+    console.error(`[prepack] SKIP (missing): ${src}`);
+    return false;
+  }
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (SKIP_DIRS.has(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else if (entry.isFile()) {
+      if (shouldSkipFile(entry.name)) continue;
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+  return true;
+}
+
+function main() {
+  const skillsDest = path.join(PLUGIN_ROOT, 'skills');
+
+  // Clean existing skills
+  if (fs.existsSync(skillsDest)) {
+    fs.rmSync(skillsDest, { recursive: true, force: true });
+  }
+  fs.mkdirSync(skillsDest, { recursive: true });
+
+  let copied = 0;
+  for (const name of CORE_SKILLS) {
+    const src = path.join(REPO_ROOT, 'skills', name);
+    const dest = path.join(skillsDest, name);
+    if (copyDir(src, dest)) {
+      copied += 1;
+      console.error(`[prepack] skills/${name}`);
+    }
+  }
+
+  if (copied !== CORE_SKILLS.length) {
+    console.error(`[prepack] ERROR: expected ${CORE_SKILLS.length} skills, copied ${copied}`);
+    process.exit(1);
+  }
+
+  console.error(`[prepack] done: ${copied} skills bundled for @boyingliu01/opencode-plugin`);
+}
+
+main();

package/plugins/opencode/skills/sprint-flow/SKILL.md

@@ -12,6 +12,7 @@ description: >
   - "start sprint"
   - "一键开发"
   - "/sprint-flow"
+  触发后第一行输出: `Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP`
   用法: /sprint-flow "[需求描述]"
   示例: /sprint-flow "开发访谈机器人，支持多轮对话"
   可选参数:
@@ -236,6 +237,36 @@ ISOLATE → AUTO-ESTIMATE → THINK → PLAN → [GITHOOKS-GATE] → BUILD → R
 
 ## 各 Phase 调用的 Skills
 
+### ⚠️ 强制输出格式规范（Mandatory Output Format）
+
+**执行每个 Phase 时，必须以以下固定格式输出阶段标题**，不可省略、不可合并、不可替换：
+
+```markdown
+## Phase -1: ISOLATE (隔离)
+## Phase -0.5: AUTO-ESTIMATE (规模评估)
+## Phase 0: THINK (思考)
+## Phase 1: PLAN (规划)
+## Phase 2: BUILD (构建)
+## Phase 3: REVIEW (评审)
+## Phase 4: USER ACCEPTANCE (用户验收)
+## Phase 5: FEEDBACK (反馈)
+## Phase 6: SHIP (发布)
+## Phase 7: LAND (部署)
+## Phase 8: CLEANUP (清理)
+```
+
+**规则**：
+1. 每个 Phase **开始执行时必须首先输出**对应的 `## Phase X: NAME` 标题行（作为该 Phase 输出的第一行）
+2. **禁止省略** "Phase" 关键词（如不能只写 "ISOLATE" 或 "## -1"）
+3. **禁止合并**多个 Phase 的输出（每个 Phase 必须有独立标题）
+4. **格式必须精确匹配**：`## Phase ` + 数字 + `: ` + 大写英文名 + ` (中文名)`
+5. 跳过某个 Phase（如 `--resume-from build` 跳过了 -1, -0.5, 0, 1）时，不输出被跳过 Phase 的标题
+6. 触发 `/sprint-flow` 后，**第一行输出应包含工作流阶段概览**：
+
+```
+Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP
+```
+
 ### Phase -1: ISOLATE（git worktree 隔离）
 
 **执行时机**: `/sprint-flow` 启动后、Phase 0 THINK 之前。**自动执行**。

package/skills/sprint-flow/SKILL.md

@@ -12,6 +12,7 @@ description: >
   - "start sprint"
   - "一键开发"
   - "/sprint-flow"
+  触发后第一行输出: `Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP`
   用法: /sprint-flow "[需求描述]"
   示例: /sprint-flow "开发访谈机器人，支持多轮对话"
   可选参数:
@@ -236,6 +237,36 @@ ISOLATE → AUTO-ESTIMATE → THINK → PLAN → [GITHOOKS-GATE] → BUILD → R
 
 ## 各 Phase 调用的 Skills
 
+### ⚠️ 强制输出格式规范（Mandatory Output Format）
+
+**执行每个 Phase 时，必须以以下固定格式输出阶段标题**，不可省略、不可合并、不可替换：
+
+```markdown
+## Phase -1: ISOLATE (隔离)
+## Phase -0.5: AUTO-ESTIMATE (规模评估)
+## Phase 0: THINK (思考)
+## Phase 1: PLAN (规划)
+## Phase 2: BUILD (构建)
+## Phase 3: REVIEW (评审)
+## Phase 4: USER ACCEPTANCE (用户验收)
+## Phase 5: FEEDBACK (反馈)
+## Phase 6: SHIP (发布)
+## Phase 7: LAND (部署)
+## Phase 8: CLEANUP (清理)
+```
+
+**规则**：
+1. 每个 Phase **开始执行时必须首先输出**对应的 `## Phase X: NAME` 标题行（作为该 Phase 输出的第一行）
+2. **禁止省略** "Phase" 关键词（如不能只写 "ISOLATE" 或 "## -1"）
+3. **禁止合并**多个 Phase 的输出（每个 Phase 必须有独立标题）
+4. **格式必须精确匹配**：`## Phase ` + 数字 + `: ` + 大写英文名 + ` (中文名)`
+5. 跳过某个 Phase（如 `--resume-from build` 跳过了 -1, -0.5, 0, 1）时，不输出被跳过 Phase 的标题
+6. 触发 `/sprint-flow` 后，**第一行输出应包含工作流阶段概览**：
+
+```
+Sprint Flow: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → USER ACCEPTANCE → FEEDBACK → SHIP → LAND → CLEANUP
+```
+
 ### Phase -1: ISOLATE（git worktree 隔离）
 
 **执行时机**: `/sprint-flow` 启动后、Phase 0 THINK 之前。**自动执行**。