@pigcloud/skills 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -1,71 +1,34 @@
-# Pig Skills CHANGELOG
-
-> 鐗堟湰鍙樻洿璁板綍锛岄伒寰?Semantic Versioning
-
----
-
-## [1.1.1] - 2026-06-18
-
-### Changed
-- Made postinstall client-aware so it can auto-install into the detected client(s) from `INIT_CWD`.
-- Kept Codex as the only client with a real command pack so `/spec-refinement` remains the executable entry instead of a fake alias.
-- Extended `pig-skills auto` to install the matching client folders for Codex, Claude Code, Trae, Cursor, Copilot, and Windsurf.
-- Clarified in the README and usage docs that only Codex gets `/spec-refinement`-style command files, while other clients receive skills and rules.
-- Unified the usage guides around the same client-detection and knowledge-capture model.
-
-## [1.1.0] - 2026-06-18
-
-### Changed
-- 閲嶆瀯 skill 浣撶郴璇存槑锛屾寜褰撳墠 13 涓?skill 閲嶆柊姊崇悊 README 鍜屼娇鐢ㄦ柟寮?
-- 琛ュ厖缁熶竴鏍￠獙鍏ュ彛 `validate-skills.js`锛屽苟澧炲姞 Windows / macOS / Linux 澹?
-- 灏嗕究鎼?Python 绾冲叆浠撳簱鍐咃紝閬垮厤渚濊禆绯荤粺鐜
-- 缁熶竴 `spec-refinement`銆乣knowledge-capture`銆乣workflow-router` 绛夐珮棰?skill 鐨勮瘑鍒笌闂ㄧ琛ㄨ揪
-- 鏀剁缉 skill frontmatter锛屾寜瀹樻柟 validator 瑙勮寖淇濈暀鏈€灏忓瓧娈?
-- 灏?`handover` 鍚堝苟杩?`knowledge-capture`锛屽垹闄ょ嫭绔嬩氦鎺?skill
-
-### Added
-- `validate-skills.js`
-- `validate-skills.cmd`
-- `validate-skills.sh`
-- `.tools/python.cmd`
-- `.tools/python.sh`
-
-## [1.0.0] - 2024-01-20
-
-### Added
-- 鍒濆鍙戝竷锛屽寘鍚?12 涓鏋剁粦瀹氭妧鑳?
-- OpenSpec 鏍囧噯鍖栬鑼?
-- 涓夊眰娓愯繘寮忓姞杞芥満鍒?
-- 璺ㄥ伐鍏峰吋瀹规敮鎸侊紙Trae/Cursor/Claude Code/Copilot/Windsurf锛?
-- CLI 宸ュ叿锛坧ig-skills 鍛戒护锛?
-
-### Skills
-- **Core**: workflow-router, technical-design, feature-build, code-review
-- **Analysis**: spec-refinement, domain-modeling
-- **Integration**: api-contract-docs, test-design
-- **Collaboration**: knowledge-capture
-- **Infrastructure**: project-bootstrap, environment-deploy
-
-### Core Bindings
-- Controller 鈫?Service 鈫?Mapper 鍒嗗眰
-- MpRealDelEntity / MpLogicDelEntity 鍩虹被
-- Result<T> 缁熶竴杩斿洖
-- BizException 寮傚父浣撶郴
-- Lambda 鏌ヨ琛ㄨ揪寮?
-
----
-
-## 璁″垝鏇存柊
-
-### [1.2.0] - TBD
-- 鎶€鑳芥ā鏉垮彲瑙嗗寲
-- 鎶€鑳界粍鍚堢紪鎺掑櫒
-- 鏇村妗嗘灦鐗瑰畾瑙勫垯
-
-### [2.0.0] - TBD
-- 鎶€鑳藉彂甯冨钩鍙?
-- 鎶€鑳借闃呮満鍒?
-- 澶氭鏋舵敮鎸?
-
-
-
+# Pig Skills Changelog
+
+> 版本变更记录，遵循 Semantic Versioning。
+
+## [1.1.1] - 2026-06-18
+
+- 调整 postinstall，让它能根据当前客户端自动安装到对应工作区。
+- 保持 Codex 的命令包入口可用，让 `/spec-refinement` 仍然是可执行入口。
+- 扩展 `pig-skills auto`，支持 Codex、Claude Code、Trae、Cursor、Copilot 和 Windsurf。
+- 在 README 和使用文档中统一说明：不同客户端共享同一套 skills 和 rules，但命令入口不同。
+- 统一客户端检测、知识沉淀和交付说明。
+
+## [1.1.0] - 2026-06-18
+
+- 重构技能体系说明，按当前 13 个 skill 重新整理 README 和使用方式。
+- 补充统一校验入口 `validate-skills.js`，并增加 Windows / macOS / Linux 支持。
+- 将便携 Python 纳入仓库内，避免依赖系统环境。
+- 统一 `spec-refinement`、`knowledge-capture`、`workflow-router` 等高频 skill 的识别与门禁表达。
+- 收缩 skill frontmatter，按官方 validator 规范保留最小字段。
+- 将 `handover` 合并入 `knowledge-capture`，删除独立交接 skill。
+
+## [1.0.6] - 2026-06-23
+
+- 将包名迁移为 `@pigcloud/skills`。
+- 统一 Codex、Trae、Claude Code 的安装和更新说明。
+- 收拢技能命名，让名称更直观、更容易理解。
+
+## [1.0.5] - 2026-06-18
+
+- 初始发布，包含 12 个框架绑定技能。
+- 建立 OpenSpec 标准化说明。
+- 引入三层渐进式加载机制。
+- 支持 Trae / Cursor / Claude Code / Copilot / Windsurf 等工具。
+- 提供 `pig-skills` CLI 工具。

package/README.md

@@ -1,76 +1,54 @@
-# @pigcloud/skills
-
-> 涓€涓潰鍚戜骇鍝併€佺爺鍙戙€佹祴璇曞崗浣滅殑 AI 鎶€鑳藉寘銆俙skills/` 璐熻矗浠诲姟杈圭晫涓庝氦鎺ワ紝`rules/` 璐熻矗瑙勫垯绾︽潫涓庢牎楠岋紝`workflow-router` 璐熻矗闃舵璺敱锛宍CI / Test / Evidence` 璐熻矗浜や粯闂幆銆?
-
-## 杩欏绯荤粺鍋氫粈涔?
-
-- 鍏堣矾鐢憋紝鍐嶆墽琛?
-- 鍏堢害鏉燂紝鍐嶇敓鎴?
-- 鍏堝鐢紝鍐嶆敼鍐?
-- 鍏堥獙璇侊紝鍐嶇粨璁?
-
-## 鏍稿績灞?
-
-1. `workflow-router`锛氳瘑鍒换鍔＄被鍨嬪苟閫夋嫨涓嬩竴闃舵
-2. `skills/`锛氬彲澶嶇敤鐨勮兘鍔涙ā鍧?
-3. `rules/`锛氶」鐩害鏉熴€佽竟鐣屽拰纭牎楠?
-4. `CI / Test / Evidence`锛氬彲楠岃瘉鐨勪氦浠橀棬绂?
-
-## 甯哥敤鍏ュ彛
-
-- 瑙勬牸婢勬竻锛歚spec-refinement`
-- 闃舵璺敱锛歚workflow-router`
-- 璁捐涓庡疄鐜帮細`technical-design` / `feature-build`
-- 瀹℃煡涓庨獙璇侊細`code-review` / `security-audit` / `performance-audit`
-- 浜嬪疄鎶藉彇锛歚business-fact-extraction`
-- 鐭ヨ瘑娌夋穩锛歚knowledge-capture`
-
-## 瀹夎
-
-```bash
-npm install -g @pigcloud/skills
-```
-
-## 瀹㈡埛绔帴鍏?
-
-- Codex锛氳 [docs/CODEX-APP-GUIDE.md](docs/CODEX-APP-GUIDE.md)
-- Trae锛氳 [docs/TRAE-GUIDE.md](docs/TRAE-GUIDE.md)
-- Claude Code锛氳 [docs/CLAUDE-CODE-GUIDE.md](docs/CLAUDE-CODE-GUIDE.md)
-- 缁熶竴瀹夎鎸囧崡锛氳 [docs/client-installation-guide.md](docs/client-installation-guide.md)
-
-## 娌荤悊姒傝
-
-- 绯荤粺鎬昏锛氳 [docs/agent-governance-overview.md](docs/agent-governance-overview.md)
-- 鎶€鑳芥墿灞曟寚鍗楋細瑙?[docs/skills-extension-guide.md](docs/skills-extension-guide.md)
-
-## 鏍￠獙
-
-```bash
-node validate-skills.js
-node scripts/validate-skill-shapes.js
-node scripts/validate-rules.js
-node scripts/validate-skill-stop-rules.js
-node scripts/validate-skill-replay-signals.js
-node self-test-skills.js
-```
-
-## 鐩綍璇存槑
-
-- `skills/`锛氭妧鑳芥鏂?
-- `skills/references/`锛氱紪鍐欐爣鍑嗐€佸弬鑰冪煩闃点€佸姞杞芥槧灏?
-- `rules/`锛氳鍒欏叆鍙ｄ笌瑙勫垯鍖?
-- `docs/`锛氬畨瑁呫€佹不鐞嗗拰宸ヤ綔娴佽鏄?
-- `bin/`锛欳LI銆佽嚜鍔ㄥ畨瑁呫€乸ostinstall
-
-## 鍏ュ彛鏂囨。
-
-- [AGENTS.md](AGENTS.md)
-- [docs/README.md](docs/README.md)
-- [docs/client-installation-guide.md](docs/client-installation-guide.md)
-- [docs/agent-governance-overview.md](docs/agent-governance-overview.md)
-- [docs/skills-extension-guide.md](docs/skills-extension-guide.md)
-- [skills/references/skill-authoring-standard.md](skills/references/skill-authoring-standard.md)
-- [skills/references/skill-reference-matrix.md](skills/references/skill-reference-matrix.md)
-- [skills/references/rule-loading-map.md](skills/references/rule-loading-map.md)
-
-
+# @pigcloud/skills
+
+> 一个面向产品、研发、测试协作的 AI 技能包。`skills/` 负责任务边界与交接，`rules/` 负责规则约束与校验，`workflow-router` 负责阶段路由，`CI / Test / Evidence` 负责交付闭环。
+
+## 这套系统做什么
+
+- 先路由，再执行
+- 先约束，再生成
+- 先复用，再改造
+- 先验证，再结论
+
+## 核心层
+
+1. `workflow-router`：识别任务类型并选择下一阶段
+2. `skills/`：可复用的能力模块
+3. `rules/`：项目约束、边界和硬校验
+4. `CI / Test / Evidence`：可验证的交付门槛
+
+## 常用入口
+
+- 规格细化：`spec-refinement`
+- 阶段路由：`workflow-router`
+- 设计与实现：`technical-design` / `feature-build`
+- 审查与验证：`code-review` / `security-audit` / `performance-audit`
+- 事实提取：`business-fact-extraction`
+
+## 安装
+
+```bash
+npm install -g @pigcloud/skills
+```
+
+安装后可使用 `pig-skills` CLI。
+
+## 目录说明
+
+- `skills/`：技能定义与交接边界
+- `skills/references/`：编写标准、参考矩阵、加载映射
+- `rules/`：规则入口与规则覆盖层
+- `docs/`：安装、治理和工作流说明
+- `bin/`：CLI 与自动安装逻辑
+
+## 客户端安装指南
+
+具体的 Codex、Trae、Claude Code 安装方式见 [docs/client-installation-guide.md](docs/client-installation-guide.md)。
+
+## 相关文档
+
+- [README.en.md](README.en.md)
+- [docs/README.md](docs/README.md)
+- [docs/client-installation-guide.md](docs/client-installation-guide.md)
+- [skills/references/skill-reference-matrix.md](skills/references/skill-reference-matrix.md)
+- [skills/references/rule-loading-map.md](skills/references/rule-loading-map.md)
+- [rules/index.md](rules/index.md)

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pigcloud/skills",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "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/",