@pigcloud/skills 1.0.7 → 1.0.9

package/bin/cli.js

@@ -3,9 +3,8 @@
 const fs = require('fs/promises');
 const fsSync = require('fs');
 const path = require('path');
-const os = require('os');
-const { detectRulesBundle } = require('./rules-loader');
-const { ensureNpmRuntime } = require('./runtime-bootstrap');
+const os = require('os');
+const { detectRulesBundle } = require('./rules-loader');
 
 const PACKAGE_ROOT = path.join(__dirname, '..');
 const SKILLS_DIR = path.join(PACKAGE_ROOT, 'skills');
@@ -463,13 +462,13 @@ function printHelp() {
   console.log('  pig-skills update [--tool codex]');
 }
 
-async function ensureRuntimeForInstall() {
-  const result = await ensureNpmRuntime({ quiet: false });
-  if (result.installed) {
-    console.log(chalk.green('Installed Node.js/npm runtime for this session.'));
-  }
-  return result;
-}
+async function ensureRuntimeForInstall() {
+  if (!commandAvailable('npm')) {
+    throw new Error('npm is not available. Install Node.js LTS first, then rerun the command.');
+  }
+
+  return { installed: false, skipped: false, npmPath: 'npm' };
+}
 
 async function run() {
   const { options, positionals } = parseArgs(process.argv.slice(2));

package/codex-commands/.codex-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "codex-commands",
+  "version": "1.1.0",
+  "description": "Codex command pack for Pig Skills. Exposes direct command-style entrypoints such as /prd and /analyze so the skill pack can be invoked without memorizing raw skill names.",
+  "author": {
+    "name": "pig-cloud-framework",
+    "url": "https://gitee.com/rebys/pig-skills"
+  },
+  "homepage": "https://gitee.com/rebys/pig-skills",
+  "repository": "https://gitee.com/rebys/pig-skills.git",
+  "license": "MIT",
+  "keywords": [
+    "codex",
+    "commands",
+    "skills",
+    "prd",
+    "analysis"
+  ],
+  "interface": {
+    "displayName": "Pig Skills Codex Commands",
+    "shortDescription": "Command-style entrypoints for the Pig Skills pack",
+    "longDescription": "Provides Codex command files like /prd, /analyze, /design, /build, and /kb that route into the Pig Skills pack with stable, low-token prompts and clear execution gates.",
+    "developerName": "pig-cloud-framework",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read"
+    ],
+    "websiteURL": "https://gitee.com/rebys/pig-skills",
+    "defaultPrompt": [
+      "Use /prd, /analyze, /design, /build, /review, or /kb to route work into the correct Pig Skill"
+    ],
+    "brandColor": "#2563EB"
+  }
+}

package/codex-commands/README.md

@@ -0,0 +1,23 @@
+# Pig Skills Codex Commands
+
+鏈彃浠舵彁渚?Pig Skills skill pack 鐨勫懡浠ゅ紡鍏ュ彛銆?
+鍏堝畨瑁?skill pack锛屽啀閲嶅惎 Codex锛屽懡浠ゆ墠浼氱敓鏁堛€?
+
+## Commands
+
+- `/spec-refinement` -> `spec-refinement`
+- `/design` -> `technical-design`
+- `/build` -> `feature-build`
+- `/review` -> `code-review`
+- `/security` -> `security-audit`
+- `/perf` -> `performance-audit`
+- `/test` -> `test-design`
+- `/doc` -> `api-contract-docs`
+- `/distill` -> `domain-modeling`
+- `/workflow` -> `workflow-router`
+- `/kb` -> `knowledge-capture`
+- `/init` -> `project-bootstrap`
+- `/infra` -> `environment-deploy`
+
+杩欎簺鍛戒护椤典繚鎸佺煭灏忥紝鏄负浜嗚 Codex 鏇村揩瀹氫綅鍒版纭殑 skill銆?
+

package/codex-commands/commands/analyze.md

@@ -0,0 +1,22 @@
+# /analyze
+
+鎶婂凡缁忕‘璁ょ殑闇€姹傛敹鏁涙垚鐮斿彂鍙墽琛岀殑瑙勬牸銆?
+
+## Route
+
+- 瀵瑰簲 skill锛歚spec-refinement`
+- 閫傜敤锛氶渶姹傛媶瑙ｃ€佽竟鐣屾⒊鐞嗐€佷緷璧栫‘璁ゃ€侀獙鏀舵爣鍑嗚ˉ鍏?
+- 涓嶉€傜敤锛氳繕娌℃敹鍙ｇ殑浜у搧璁ㄨ
+
+## Workflow
+
+1. 鍏堢‘璁よ緭鍏ュ凡缁忔敹鏁涘埌鍙墽琛岃鏍笺€?
+2. 鎶婄洰鏍囥€佽竟鐣屻€佷緷璧栥€佺害鏉熷拰楠屾敹鏉′欢鏁寸悊鎴愬彲鎵ц瑙勬牸銆?
+3. 杈撳嚭鐮斿彂鍒嗘瀽缁撴灉锛屾槑纭悗缁疄鐜版墍闇€杈撳叆銆?
+4. 蹇呰鏃朵氦缁?`technical-design` 鎴?`knowledge-capture`銆?
+
+## Guardrails
+
+- 涓嶇洿鎺ュ啓瀹炵幇浠ｇ爜銆?
+- 涓嶆妸鏈‘璁ゅ亣璁惧綋缁撹銆?
+

package/codex-commands/commands/build.md

@@ -0,0 +1,22 @@
+# /build
+
+鎸夋柟妗堣鑼冨疄鐜板凡缁忔敹鍙ｇ殑闇€姹傘€?
+
+## Route
+
+- 瀵瑰簲 skill锛歚feature-build`
+- 閫傜敤锛氬紑鍙戝疄鐜般€佸閲忔敼閫犮€佹帴鍙ｈ仈鍔ㄣ€佽惤鍦颁唬鐮?
+- 涓嶉€傜敤锛氶渶姹傝繕娌℃敹鍙ｏ紝鎴栬€呰璁¤繕娌＄ǔ瀹?
+
+## Workflow
+
+1. 鍏堢‘璁よ緭鍏ユ潵鑷?`spec-refinement` 鎴?`technical-design`銆?
+2. 鎸夊垎灞傘€佷簨鍔″拰杩斿洖鍊艰鑼冨疄鐜般€?
+3. 淇濇寔鏀瑰姩鏈€灏忥紝浼樺厛鍙獙璇併€?
+4. 浜ょ粰 `test-design` 鍜?`code-review` 鏀跺彛銆?
+
+## Guardrails
+
+- 涓嶇粫杩囨灦鏋勭害鏉熴€?
+- 涓嶆妸涓存椂淇ˉ褰撲綔鏈€缁堝疄鐜般€?
+

package/codex-commands/commands/design.md

@@ -0,0 +1,22 @@
+# /design
+
+鎶婂凡缁忔敹鍙ｇ殑闇€姹傝ˉ鎴愬彲瀹炵幇鐨勬妧鏈柟妗堛€?
+
+## Route
+
+- 瀵瑰簲 skill锛歚technical-design`
+- 閫傜敤锛氭灦鏋勯€夊瀷銆佹ā鍧楁媶鍒嗐€佹帴鍙ｈ璁°€佹暟鎹祦璁捐銆佸疄鐜板墠琛ュ厖璁捐
+- 涓嶉€傜敤锛氬皻鏈敹鍙ｇ殑闇€姹傝璁?
+
+## Workflow
+
+1. 璇诲彇 `spec-refinement` 鐨勭粨璁恒€?
+2. 鎷嗗垎妯″潡銆佹帴鍙ｃ€佹暟鎹粨鏋勩€佷簨鍔¤竟鐣屽拰寮傚父璺緞銆?
+3. 杈撳嚭鏂规鑽夊浘銆佸叧閿喅绛栧拰钀藉湴椤哄簭銆?
+4. 缁?`feature-build` 鍑嗗瀹炵幇杈撳叆銆?
+
+## Guardrails
+
+- 涓嶉噸鏂板彂鏁ｉ渶姹傝寖鍥淬€?
+- 涓嶈烦杩囨灦鏋勭害鏉熺洿鎺ュ啓瀹炵幇銆?
+

package/codex-commands/commands/distill.md

@@ -0,0 +1,21 @@
+# /distill
+
+把业务事实提炼成可复用的领域知识。
+
+## Route
+
+- 对应 skill：`domain-modeling`
+- 适用：领域边界、实体关系、核心概念、规则沉淀
+- 不适用：纯接口变更说明
+
+## Workflow
+
+1. 识别业务对象、边界和核心规则。
+2. 抽取实体、关系、状态和约束。
+3. 输出可复用的领域索引和冲突点。
+4. 不把命名本身当作领域模型。
+
+## Guardrails
+
+- 不忽略规则冲突。
+- 不把实现细节冒充领域知识。

package/codex-commands/commands/doc.md

@@ -0,0 +1,22 @@
+# /doc
+
+鎶婃帴鍙ｅ拰鍙樻洿鏁寸悊鎴愬彲瀵规帴鐨勬枃妗ｃ€?
+
+## Route
+
+- 瀵瑰簲 skill锛歚api-contract-docs`
+- 閫傜敤锛氭帴鍙ｈ鏄庛€佸彉鏇磋鏄庛€佽仈璋冭鏄庛€佸悓姝ユ枃妗?
+- 涓嶉€傜敤锛氱函浠ｇ爜瀹℃煡
+
+## Workflow
+
+1. 鍏堢‘璁ゆ帴鍙ｈ竟鐣屽拰杈撳叆杈撳嚭銆?
+2. 鎻愮偧璇锋眰銆佸搷搴斻€侀敊璇爜鍜岃皟鐢ㄩ『搴忋€?
+3. 杈撳嚭鍙仈璋冪殑鏂囨。鑽夋銆?
+4. 鍙樻洿鍚庡悓姝ュ埌鐭ヨ瘑娌夋穩銆?
+
+## Guardrails
+
+- 涓嶉仐婕忛敊璇繑鍥炲拰绾︽潫銆?
+- 涓嶆妸绌烘硾璇存槑褰撴垚鏂囨。浜や粯銆?
+

package/codex-commands/commands/infra.md

@@ -0,0 +1,21 @@
+# /infra
+
+准备或管理开发依赖的基础设施。
+
+## Route
+
+- 对应 skill：`environment-deploy`
+- 适用：Docker Compose、依赖服务启动、开发联调环境准备
+- 不适用：业务需求分析
+
+## Workflow
+
+1. 识别需要启动的基础设施组件。
+2. 只拉起最小可用组合。
+3. 输出启动状态和常见失败点。
+4. 不把生产部署和本地开发混在一起。
+
+## Guardrails
+
+- 不默认启动多余服务。
+- 不混淆生产环境和本地环境。

package/codex-commands/commands/init.md

@@ -0,0 +1,20 @@
+# /init
+
+初始化项目或模块脚手架。
+
+## Route
+
+- 对应 skill：`project-bootstrap`
+- 适用：新建项目、模块初始化、标准目录生成
+- 不适用：业务分析
+
+## Workflow
+
+1. 确认初始化对象是项目还是模块。
+2. 生成标准目录、基础配置和依赖边界。
+3. 输出后续应该进入的 skill。
+4. 不触碰具体业务逻辑。
+
+## Guardrails
+
+- 不跳过基础配置检查。

package/codex-commands/commands/kb.md

@@ -0,0 +1,20 @@
+# /kb
+
+把项目事实整理成可检索、可复用、可过期治理的知识中心。
+
+## Route
+
+- 对应 skill：`knowledge-capture`
+- 适用：项目概览、模块索引、领域知识、方案沉淀、交接归档
+
+## Workflow
+
+1. 收集事实、来源、适用场景和限制条件。
+2. 分类沉淀到项目、模块、领域、方案或协作索引。
+3. 标明哪些内容可复用，哪些内容应过期清理。
+4. 让归档结果反哺后续分析和实现。
+
+## Guardrails
+
+- 不堆文档。
+- 不把未经验证的信息当知识沉淀。

package/codex-commands/commands/perf.md

@@ -0,0 +1,21 @@
+# /perf
+
+妫€鏌ユ€ц兘鐑偣銆佺摱棰堝拰鍥炲綊椋庨櫓銆?
+
+## Route
+
+- 瀵瑰簲 skill锛歚performance-audit`
+- 閫傜敤锛歂+1銆佺紦瀛樸€佺储寮曘€佹壒閲忔搷浣溿€佺儹鐐硅矾寰?
+- 涓嶉€傜敤锛氱函瀹夊叏瀹℃煡鎴栫函闇€姹傝璁?
+
+## Workflow
+
+1. 鎵惧嚭楂橀璺緞鍜屽ぇ鏁版嵁閲忚矾寰勩€?
+2. 妫€鏌ユ暟鎹簱璁块棶銆佺紦瀛樺懡涓€佸惊鐜皟鐢ㄥ拰鎵瑰鐞嗐€?
+3. 杈撳嚭鍙獙璇佺殑鎬ц兘椋庨櫓鍜屼紭鍖栭『搴忋€?
+4. 蹇呰鏃朵氦缁?`code-review` 鎴?`feature-build`銆?
+
+## Guardrails
+
+- 涓嶇敤娉涙硾寤鸿鏇夸唬瀹氫綅缁撹銆?
+

package/codex-commands/commands/prd.md

@@ -0,0 +1,22 @@
+# /prd
+
+鎶婁骇鍝佹剰鍥炬敹鍙ｆ垚缁欑爺鍙戝垎鏋愪娇鐢ㄧ殑闇€姹傝緭鍏ャ€?
+
+## Route
+
+- 瀵瑰簲 skill锛歚spec-refinement`
+- 閫傜敤锛氫骇鍝佺洰鏍囥€佷笟鍔¤儗鏅€佽寖鍥磋鍓€佷紭鍏堢骇銆侀獙鏀跺彛寰勩€侀渶姹傚垵绋?
+- 涓嶉€傜敤锛氬凡缁忚繘鍏ュ疄鐜扮粏鑺傜殑鐮斿彂鍒嗘瀽
+
+## Workflow
+
+1. 鍏堢‘璁よ繖鏄骇鍝佷晶闇€姹傦紝涓嶇洿鎺ヨ繘鍏ヨ璁℃垨缂栫爜銆?
+2. 鏀堕泦鐩爣銆佽寖鍥淬€佺害鏉熴€佷紭鍏堢骇鍜岄獙鏀舵爣鍑嗐€?
+3. 杈撳嚭缁撴瀯鍖栫殑 PRD-ready brief銆?
+4. 浜ょ粰 `technical-design`銆?
+
+## Guardrails
+
+- 涓嶆浛浠ｇ爺鍙戦渶姹傚垎鏋愩€?
+- 涓嶈烦杩囬渶姹傛敹鍙ｇ洿鎺ュ啓鏈€缁堢粨璁恒€?
+

package/codex-commands/commands/review.md

@@ -0,0 +1,22 @@
+# /review
+
+瀹℃煡浠ｇ爜鍙樻洿銆佽川閲忛闄╁拰璺ㄦā鍧楀奖鍝嶃€?
+
+## Route
+
+- 瀵瑰簲 skill锛歚code-review`
+- 閫傜敤锛歅R 瀹℃煡銆乨iff 瀹℃牳銆佷笂绾垮墠妫€鏌ャ€佹鏋惰鑼冩牳瀵?
+- 涓嶉€傜敤锛氱函闇€姹傝璁?
+
+## Workflow
+
+1. 鍏堢‘璁ゅ彉鏇磋寖鍥达紝涓嶅彧鐪嬪崟鏂囦欢銆?
+2. 鏍稿鏋舵瀯銆佽竟鐣屻€佸洖褰掗闄╁拰绾︽潫銆?
+3. 杈撳嚭闂绾у埆銆侀闄╁拰淇寤鸿銆?
+4. 蹇呰鏃惰ˉ `security-audit` 鎴?`performance-audit`銆?
+
+## Guardrails
+
+- 鍙鏌ュ凡缁忓彂鐢熺殑鍙樻洿銆?
+- 涓嶈烦杩囪瘉鎹洿鎺ヤ笅缁撹銆?
+

package/codex-commands/commands/security.md

@@ -0,0 +1,22 @@
+# /security
+
+瀹℃煡瀹夊叏椋庨櫓銆佹潈闄愯竟鐣屽拰鏁忔劅鏁版嵁鏆撮湶銆?
+
+## Route
+
+- 瀵瑰簲 skill锛歚security-audit`
+- 閫傜敤锛氬畨鍏ㄥ鏌ャ€佹潈闄愭鏌ャ€佹暟鎹毚闇叉鏌ャ€佸悎瑙勯闄╂鏌?
+- 涓嶉€傜敤锛氭櫘閫氶渶姹傝璁?
+
+## Workflow
+
+1. 鍏堢‘璁よ緭鍏ユ槸宸茬粡鍙戠敓鐨勫彉鏇存垨鍙鏌ョ殑鏂规銆?
+2. 鎷嗗垎鎺ュ彛銆佹潈闄愩€佹暟鎹祦鍚戝拰鏁忔劅淇℃伅椋庨櫓銆?
+3. 杈撳嚭瀹夊叏鍙戠幇銆佷紭鍏堢骇鍜屼慨澶嶅缓璁€?
+4. 蹇呰鏃朵氦缁?`knowledge-capture` 鎴?`feature-build`銆?
+
+## Guardrails
+
+- 涓嶇洿鎺ヤ慨鏀圭敓浜т唬鐮併€?
+- 涓嶆妸涓€鑸川閲忛棶棰樿鍒ゆ垚瀹夊叏缁撹銆?
+

package/codex-commands/commands/test.md

@@ -0,0 +1,21 @@
+# /test
+
+把验收标准转成可执行的测试设计。
+
+## Route
+
+- 对应 skill：`test-design`
+- 适用：测试策略、用例设计、回归矩阵、验证路径
+- 不适用：需求还不明确，或者只是想“快速跑一下”
+
+## Workflow
+
+1. 先确认验收标准或实现结果。
+2. 转成测试策略、用例、回归和边界场景。
+3. 输出可执行的验证方案。
+4. 必要时交给 `code-review` 或 `feature-build`。
+
+## Guardrails
+
+- 不跳过前置条件。
+- 不把“跑过一次”当作完整验证。

package/codex-commands/commands/workflow.md

@@ -0,0 +1,20 @@
+# /workflow
+
+按阶段路由到正确的 skill，并控制阶段切换。
+
+## Route
+
+- 适用：多阶段任务、跨 skill 协作、门禁控制、阶段切换
+- 不适用：单一步骤的小任务
+
+## Workflow
+
+1. 判断当前处于哪个生命周期阶段。
+2. 选择当前 skill 或下一步 skill。
+3. 如果门禁失败，暂停下游并说明原因。
+4. 记录下一步应该走哪个 skill。
+
+## Guardrails
+
+- 不替用户决定跳过阶段。
+- 不让下游覆盖上游未确认结果。

package/install.cmd

@@ -1,5 +1,5 @@
-@echo off
-setlocal
-set "SCRIPT_DIR=%~dp0"
-powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%install.ps1" %*
-exit /b %ERRORLEVEL%
+@echo off
+setlocal
+set "SCRIPT_DIR=%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%install.ps1" %*
+exit /b %ERRORLEVEL%

package/install.ps1

@@ -1,74 +1,30 @@
-param(
-    [switch]$SkipRuntimeBootstrap,
-    [switch]$SkipPostInstallSync
-)
-
-$ErrorActionPreference = 'Stop'
-
-function Write-Info([string]$Message) {
-    Write-Host $Message
-}
-
-function Write-Warn([string]$Message) {
-    Write-Warning $Message
-}
-
-function Test-Command([string]$Name) {
-    return [bool](Get-Command $Name -ErrorAction SilentlyContinue)
-}
-
-function Ensure-NodeRuntime {
-    if (Test-Command npm) {
-        return
-    }
-
-    if ($SkipRuntimeBootstrap -or $env:PIG_SKILLS_SKIP_RUNTIME_BOOTSTRAP -match '^(1|true|yes)$') {
-        throw 'npm is not available and runtime bootstrap is disabled. Install Node.js LTS first, then rerun.'
-    }
-
-    if (-not (Test-Command winget)) {
-        throw 'npm is not available and winget is missing. Install Node.js LTS manually, then rerun.'
-    }
-
-    Write-Info 'npm is missing. Installing Node.js LTS via winget...'
-    & winget install --id OpenJS.NodeJS.LTS -e --source winget --accept-package-agreements --accept-source-agreements --silent --disable-interactivity | Out-Null
-    if ($LASTEXITCODE -ne 0) {
-        throw "winget install failed with exit code $LASTEXITCODE"
-    }
-
-    $programFilesX86 = [Environment]::GetEnvironmentVariable('ProgramFiles(x86)')
-    $nodeDirCandidates = @(
-        Join-Path $env:ProgramFiles 'nodejs',
-        if ($programFilesX86) { Join-Path $programFilesX86 'nodejs' },
-        Join-Path $env:LocalAppData 'Programs\nodejs',
-        Join-Path $env:LocalAppData 'Microsoft\WinGet\Links'
-    ) | Where-Object { $_ -and (Test-Path $_) }
-
-    foreach ($candidate in $nodeDirCandidates) {
-        if (-not (($env:PATH -split ';') -contains $candidate)) {
-            $env:PATH = "$candidate;$env:PATH"
-        }
-    }
-
-    if (-not (Test-Command npm)) {
-        throw 'Node.js was installed, but npm is still not visible in this shell. Restart the shell and rerun.'
-    }
-}
-
-function Install-Package {
-    $repoRoot = (Resolve-Path -LiteralPath $PSScriptRoot).Path
-    $npmArgs = @('install', '-g', $repoRoot)
-    if ($SkipPostInstallSync) {
-        $env:PIG_SKILLS_SKIP_AUTO_SYNC = '1'
-    }
-
-    Write-Info "Installing Pig Skills from $repoRoot ..."
-    & npm @npmArgs
-    if ($LASTEXITCODE -ne 0) {
-        throw "npm install failed with exit code $LASTEXITCODE"
-    }
-}
-
-Ensure-NodeRuntime
-Install-Package
-Write-Info 'Pig Skills installation complete.'
+param(
+    [switch]$SkipPostInstallSync
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Write-Info([string]$Message) {
+    Write-Host $Message
+}
+
+function Test-Command([string]$Name) {
+    return [bool](Get-Command $Name -ErrorAction SilentlyContinue)
+}
+
+if (-not (Test-Command npm)) {
+    throw 'npm is not available. Install Node.js LTS first, then rerun.'
+}
+
+$repoRoot = (Resolve-Path -LiteralPath $PSScriptRoot).Path
+if ($SkipPostInstallSync -or $env:PIG_SKILLS_SKIP_AUTO_SYNC -match '^(1|true|yes)$') {
+    $env:PIG_SKILLS_SKIP_AUTO_SYNC = '1'
+}
+
+Write-Info "Installing Pig Skills from $repoRoot ..."
+& npm install -g $repoRoot
+if ($LASTEXITCODE -ne 0) {
+    throw "npm install failed with exit code $LASTEXITCODE"
+}
+
+Write-Info 'Pig Skills installation complete.'

package/install.sh

@@ -1,168 +1,36 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$SCRIPT_DIR"
-SKIP_RUNTIME_BOOTSTRAP="${PIG_SKILLS_SKIP_RUNTIME_BOOTSTRAP:-0}"
-SKIP_POSTINSTALL_SYNC="${PIG_SKILLS_SKIP_AUTO_SYNC:-0}"
-
-for arg in "$@"; do
-  case "$arg" in
-    --skip-runtime-bootstrap)
-      SKIP_RUNTIME_BOOTSTRAP=1
-      ;;
-    --skip-postinstall-sync)
-      SKIP_POSTINSTALL_SYNC=1
-      ;;
-  esac
-done
-
-log() {
-  printf '%s\n' "$1"
-}
-
-warn() {
-  printf '%s\n' "$1" >&2
-}
-
-has_command() {
-  command -v "$1" >/dev/null 2>&1
-}
-
-is_true() {
-  case "${1:-}" in
-    1|true|TRUE|yes|YES) return 0 ;;
-    *) return 1 ;;
-  esac
-}
-
-run_privileged() {
-  if [ "$(id -u)" -eq 0 ]; then
-    "$@"
-    return
-  fi
-
-  if has_command sudo; then
-    sudo "$@"
-    return
-  fi
-
-  die "Command requires elevated privileges: $*"
-}
-
-die() {
-  warn "$1"
-  exit 1
-}
-
-bootstrap_with_nvm() {
-  if ! has_command curl; then
-    die "curl is required to bootstrap Node.js via nvm."
-  fi
-  if ! has_command git; then
-    die "git is required to bootstrap Node.js via nvm."
-  fi
-
-  export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
-  if [ ! -s "$NVM_DIR/nvm.sh" ]; then
-    log "npm is missing. Installing nvm and Node.js LTS..."
-    mkdir -p "$NVM_DIR"
-    tmp_install_script="$(mktemp "${TMPDIR:-/tmp}/pig-skills-nvm.XXXXXX")"
-    curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh -o "$tmp_install_script"
-    bash "$tmp_install_script"
-    rm -f "$tmp_install_script"
-  fi
-
-  # shellcheck disable=SC1090
-  [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
-  # shellcheck disable=SC1091
-  [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
-  nvm install --lts
-  nvm use --lts
-}
-
-bootstrap_on_macos() {
-  if has_command brew; then
-    log "npm is missing. Installing Node.js via Homebrew..."
-    brew install node
-    return
-  fi
-
-  bootstrap_with_nvm
-}
-
-bootstrap_on_linux() {
-  if has_command apt-get; then
-    log "npm is missing. Installing Node.js via apt..."
-    run_privileged apt-get update
-    run_privileged apt-get install -y nodejs npm
-    return
-  fi
-
-  if has_command dnf; then
-    log "npm is missing. Installing Node.js via dnf..."
-    run_privileged dnf install -y nodejs npm
-    return
-  fi
-
-  if has_command yum; then
-    log "npm is missing. Installing Node.js via yum..."
-    run_privileged yum install -y nodejs npm
-    return
-  fi
-
-  if has_command pacman; then
-    log "npm is missing. Installing Node.js via pacman..."
-    run_privileged pacman -Sy --noconfirm nodejs npm
-    return
-  fi
-
-  if has_command zypper; then
-    log "npm is missing. Installing Node.js via zypper..."
-    run_privileged zypper --non-interactive install nodejs npm
-    return
-  fi
-
-  if has_command apk; then
-    log "npm is missing. Installing Node.js via apk..."
-    run_privileged apk add nodejs npm
-    return
-  fi
-
-  bootstrap_with_nvm
-}
-
-ensure_node_runtime() {
-  if has_command npm; then
-    return
-  fi
-
-  if is_true "$SKIP_RUNTIME_BOOTSTRAP"; then
-    die "npm is not available and runtime bootstrap is disabled. Install Node.js LTS first, then rerun."
-  fi
-
-  case "$(uname -s)" in
-    Darwin) bootstrap_on_macos ;;
-    Linux) bootstrap_on_linux ;;
-    *)
-      die "Unsupported platform for automatic bootstrap. Install Node.js LTS manually, then rerun."
-      ;;
-  esac
-
-  if ! has_command npm; then
-    die "Node.js was installed, but npm is still not visible in this shell. Restart the shell and rerun."
-  fi
-}
-
-install_package() {
-  log "Installing Pig Skills from $REPO_ROOT ..."
-  if is_true "$SKIP_POSTINSTALL_SYNC"; then
-    PIG_SKILLS_SKIP_AUTO_SYNC=1 npm install -g "$REPO_ROOT"
-  else
-    npm install -g "$REPO_ROOT"
-  fi
-}
-
-ensure_node_runtime
-install_package
-log "Pig Skills installation complete."
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$SCRIPT_DIR"
+SKIP_POSTINSTALL_SYNC="${PIG_SKILLS_SKIP_AUTO_SYNC:-0}"
+
+for arg in "$@"; do
+  case "$arg" in
+    --skip-postinstall-sync)
+      SKIP_POSTINSTALL_SYNC=1
+      ;;
+  esac
+done
+
+log() {
+  printf '%s\n' "$1"
+}
+
+die() {
+  printf '%s\n' "$1" >&2
+  exit 1
+}
+
+if ! command -v npm >/dev/null 2>&1; then
+  die 'npm is not available. Install Node.js LTS first, then rerun.'
+fi
+
+log "Installing Pig Skills from $REPO_ROOT ..."
+if [ "$SKIP_POSTINSTALL_SYNC" = "1" ] || [ "${SKIP_POSTINSTALL_SYNC,,}" = "true" ] || [ "${SKIP_POSTINSTALL_SYNC,,}" = "yes" ]; then
+  PIG_SKILLS_SKIP_AUTO_SYNC=1 npm install -g "$REPO_ROOT"
+else
+  npm install -g "$REPO_ROOT"
+fi
+
+log 'Pig Skills installation complete.'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pigcloud/skills",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "面向 Codex、Trae 和 Claude Code 的 AI 技能包，提供共享技能、规则约束、工作流路由和 Pig Cloud 专属覆盖层。",
   "author": "Pig Skills Maintainers",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "install.cmd",
     "install.ps1",
     "install.sh",
-    "pig-cloud-skills-commands/",
+    "codex-commands/",
     "rules/",
     "skills/",
     "scripts/",

package/bin/runtime-bootstrap.js

@@ -1,121 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const NPM_CANDIDATES = process.platform === 'win32'
-  ? [
-      path.join(process.env.ProgramFiles || 'C:\\Program Files', 'nodejs', 'npm.cmd'),
-      path.join(process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)', 'nodejs', 'npm.cmd'),
-      path.join(process.env.LocalAppData || '', 'Programs', 'nodejs', 'npm.cmd'),
-      path.join(process.env.LocalAppData || '', 'Microsoft', 'WinGet', 'Links', 'npm.cmd')
-    ]
-  : [];
-
-function commandAvailable(command) {
-  const result = spawnSync(command, ['--version'], { stdio: 'ignore' });
-  return !result.error && result.status === 0;
-}
-
-function findInstalledNpm() {
-  for (const candidate of NPM_CANDIDATES) {
-    if (candidate && fs.existsSync(candidate)) {
-      return candidate;
-    }
-  }
-  return null;
-}
-
-function refreshPathFromNpm(npmPath) {
-  if (!npmPath) return;
-  const npmDir = path.dirname(npmPath);
-  const currentPath = String(process.env.PATH || '');
-  const parts = currentPath.split(path.delimiter).filter(Boolean);
-  if (!parts.some((part) => part.toLowerCase() === npmDir.toLowerCase())) {
-    process.env.PATH = [npmDir, ...parts].join(path.delimiter);
-  }
-}
-
-function installNodeJsWithWinget() {
-  const args = [
-    'install',
-    '--id',
-    'OpenJS.NodeJS.LTS',
-    '-e',
-    '--source',
-    'winget',
-    '--accept-package-agreements',
-    '--accept-source-agreements',
-    '--silent',
-    '--disable-interactivity'
-  ];
-
-  const result = spawnSync('winget', args, {
-    encoding: 'utf8',
-    stdio: ['ignore', 'pipe', 'pipe']
-  });
-
-  if (result.error) {
-    throw new Error(`Failed to launch winget: ${result.error.message}`);
-  }
-
-  if (result.status !== 0) {
-    const message = [result.stdout, result.stderr]
-      .filter(Boolean)
-      .map((text) => String(text).trim())
-      .filter(Boolean)
-      .join('\n');
-    throw new Error(message || `winget exited with code ${result.status}`);
-  }
-}
-
-async function ensureNpmRuntime(options = {}) {
-  const skip = ['1', 'true', 'yes'].includes(String(process.env.PIG_SKILLS_SKIP_RUNTIME_BOOTSTRAP || '').toLowerCase());
-  if (skip) {
-    return { installed: false, skipped: true, npmPath: commandAvailable('npm') ? 'npm' : null };
-  }
-
-  if (commandAvailable('npm')) {
-    return { installed: false, skipped: false, npmPath: 'npm' };
-  }
-
-  if (process.platform !== 'win32') {
-    throw new Error(
-      'npm is not available in PATH. Install Node.js 20+ first, then rerun the skill installer.'
-    );
-  }
-
-  if (!commandAvailable('winget')) {
-    throw new Error(
-      'npm is not available and winget is not installed. Install Node.js LTS manually, then rerun the skill installer.'
-    );
-  }
-
-  if (!options.quiet) {
-    process.stdout.write('npm is missing. Installing Node.js LTS through winget...\n');
-  }
-
-  installNodeJsWithWinget();
-
-  const npmPath = findInstalledNpm();
-  refreshPathFromNpm(npmPath);
-
-  if (!npmPath && !commandAvailable('npm')) {
-    throw new Error(
-      'Node.js was installed, but npm is still not visible in this shell. Restart the shell and rerun the skill installer.'
-    );
-  }
-
-  return {
-    installed: true,
-    skipped: false,
-    npmPath: npmPath || 'npm'
-  };
-}
-
-module.exports = {
-  ensureNpmRuntime,
-  commandAvailable,
-  findInstalledNpm
-};