@pigcloud/skills 1.0.10 → 1.1.2

package/CHANGELOG.md

@@ -1,34 +1,39 @@
 # Pig Skills Changelog
 
-> 版本变更记录，遵循 Semantic Versioning。
+## [1.1.2] - 2026-06-28
+
+- Rebuilt the skill package layout so each skill owns its own references, assets, and prompt suite.
+- Removed the stage-level shared references bundle and moved the generated replay inputs to per-skill locations.
+- Added `skill-spec.json` as the per-skill design source and updated the generators and validators to use it.
+- Tightened the rules and skill validation flow so the current repository structure is enforced directly.
 
 ## [1.1.1] - 2026-06-18
 
-- 调整 postinstall，让它能根据当前客户端自动安装到对应工作区。
-- 保持 Codex 的命令包入口可用，让 `/spec-refinement` 仍然是可执行入口。
-- 扩展 `pig-skills auto`，支持 Codex、Claude Code、Trae、Cursor、Copilot 和 Windsurf。
-- 在 README 和使用文档中统一说明：不同客户端共享同一套 skills 和 rules，但命令入口不同。
-- 统一客户端检测、知识沉淀和交付说明。
+- Adjusted `postinstall` so it can install the matching workspace bundle for the current client automatically.
+- Kept the Codex command entry usable while the command map moved to the current skill set.
+- Expanded `pig-skills auto` to support Codex, Claude Code, Trae, Cursor, Copilot, and Windsurf.
+- Unified the README and usage docs so every client shares the same `skills` and `rules` sources while keeping separate command entry points.
+- Unified client-side validation, knowledge capture, and delivery guidance around the current repository structure.
 
 ## [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。
+- Reworked the skill system docs and reorganized the current skill set into the shared README and usage flow.
+- Added the unified validation entry `validate-skills.js` and expanded Windows / macOS / Linux support.
+- Brought the repository-local Python helpers into the repo so the workflow does not depend on the system environment.
+- Unified the identification and gating language for the high-frequency skills used in discovery, design, implementation, validation, and delivery.
+- Shrunk skill frontmatter to keep only the minimum fields required by the official validator.
+- Merged the historical handoff flow into the current knowledge capture flow and removed the standalone handoff skill.
 
 ## [1.0.6] - 2026-06-23
 
-- 将包名迁移为 `@pigcloud/skills`。
-- 统一 Codex、Trae、Claude Code 的安装和更新说明。
-- 收拢技能命名，让名称更直观、更容易理解。
+- Renamed the package to `@pigcloud/skills`.
+- Unified install and update guidance across Codex, Trae, and Claude Code.
+- Simplified skill naming so the current terms are easier to read and remember.
 
 ## [1.0.5] - 2026-06-18
 
-- 初始发布，包含 12 个框架绑定技能。
-- 建立 OpenSpec 标准化说明。
-- 引入三层渐进式加载机制。
-- 支持 Trae / Cursor / Claude Code / Copilot / Windsurf 等工具。
-- 提供 `pig-skills` CLI 工具。
+- Initial release with 12 framework-bound skills.
+- Established the standardized docs for the current workflow.
+- Introduced the layered loading model.
+- Added support for Trae, Cursor, Claude Code, Copilot, and Windsurf.
+- Shipped the `pig-skills` CLI.

package/README.en.md

@@ -1,75 +1,41 @@
-# @pigcloud/skills
-
-> An AI skills pack for product, engineering, and QA collaboration. `skills/` carries reusable capabilities, `rules/` carries constraints and validation, `workflow-router` handles stage routing, and `CI / Test / Evidence` completes the delivery loop.
-
-## What this system does
-
-- Route first, then execute
-- Constrain first, then generate
-- Reuse first, then rewrite
-- Verify first, then conclude
-
-## Core Layers
-
-1. `workflow-router`: identifies the task type and chooses the next stage
-2. `skills/`: reusable capability modules
-3. `rules/`: project constraints, boundaries, and hard checks
-4. `CI / Test / Evidence`: verifiable delivery gates
-
-## Common Entry Points
-
-- Spec: `spec-refinement`
-- Stage routing: `workflow-router`
-- Design and implementation: `technical-design` / `feature-build`
-- Review and validation: `code-review` / `security-audit` / `performance-audit`
-- Fact extraction: `business-fact-extraction`
-- Knowledge capture: `knowledge-capture`
-
-## Install
-
-```bash
-npm install -g @pigcloud/skills
-```
-
-## Client Setup
-
-- Codex: see [docs/CODEX-APP-GUIDE.md](docs/CODEX-APP-GUIDE.md)
-- Trae: see [docs/TRAE-GUIDE.md](docs/TRAE-GUIDE.md)
-- Claude Code: see [docs/CLAUDE-CODE-GUIDE.md](docs/CLAUDE-CODE-GUIDE.md)
-- Unified installation guide: see [docs/client-installation-guide.md](docs/client-installation-guide.md)
-
-## Governance Overview
-
-- System overview: [docs/agent-governance-overview.md](docs/agent-governance-overview.md)
-- Skills extension guide: [docs/skills-extension-guide.md](docs/skills-extension-guide.md)
-
-## Validation
-
-```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
-```
-
-## Directory Map
-
-- `skills/`: skill bodies
-- `skills/references/`: authoring standard, reference matrix, loading map
-- `rules/`: rule entry point and bundles
-- `docs/`: install, governance, and workflow notes
-- `bin/`: CLI, auto-install, postinstall
-
-## Entry Docs
-
-- [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
+
+A lightweight AI skills pack. Each skill handles one clear boundary, and the homepage keeps only the current canonical skills.
+
+## Canonical Skills
+
+- `01-discovery`: `requirement-discovery`, `business-analysis`, `ambiguity-detection`, `impact-analysis`
+- `02-design`: `architecture-design`, `api-design`, `database-design`, `task-breakdown`
+- `03-implementation`: `backend-development`, `frontend-development`, `database-change`, `bug-fix`
+- `04-validation`: `unit-test`, `code-review`, `security-review`, `performance-review`, `regression-check`
+- `05-delivery`: `release-check`, `release-validation`, `change-log`, `deployment-guide`
+- `shared`: `framework-guide`, `codebase-learning`, `evidence-collector`
+
+## Install
+
+```bash
+npm install -g @pigcloud/skills
+```
+
+## Client Entry Points
+
+- 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)
+- GitHub Copilot: [docs/COPILOT-GUIDE.md](docs/COPILOT-GUIDE.md)
+- Cursor: [docs/CURSOR-GUIDE.md](docs/CURSOR-GUIDE.md)
+- Windsurf: [docs/WINDSURF-GUIDE.md](docs/WINDSURF-GUIDE.md)
+- Install / uninstall / update: [docs/install-uninstall-update-guide.md](docs/install-uninstall-update-guide.md)
+
+## Docs
+
+- [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)
+
+## Conventions
+
+- `skills/` contains skill bodies.
+- `rules/` contains constraints and checks.
+- `docs/` stays short and practical.
+- Keep the homepage concise; move details into dedicated docs.

package/README.md

@@ -1,54 +1,41 @@
 # @pigcloud/skills
 
-> 一个面向产品、研发、测试协作的 AI 技能包。`skills/` 负责任务边界与交接，`rules/` 负责规则约束与校验，`workflow-router` 负责阶段路由，`CI / Test / Evidence` 负责交付闭环。
+一个轻量的 AI skills pack。每个 skill 只负责一个清晰边界，首页只保留当前 canonical skills。
 
-## 这套系统做什么
+## Canonical Skills
 
-- 先路由，再执行
-- 先约束，再生成
-- 先复用，再改造
-- 先验证，再结论
+- `01-discovery`: `requirement-discovery`, `business-analysis`, `ambiguity-detection`, `impact-analysis`
+- `02-design`: `architecture-design`, `api-design`, `database-design`, `task-breakdown`
+- `03-implementation`: `backend-development`, `frontend-development`, `database-change`, `bug-fix`
+- `04-validation`: `unit-test`, `code-review`, `security-review`, `performance-review`, `regression-check`
+- `05-delivery`: `release-check`, `release-validation`, `change-log`, `deployment-guide`
+- `shared`: `framework-guide`, `codebase-learning`, `evidence-collector`
 
-## 核心层
-
-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`
-
-## 安装
+## Install
 
 ```bash
 npm install -g @pigcloud/skills
 ```
 
-安装后可使用 `pig-skills` CLI。
-
-## 目录说明
+## Client Entry Points
 
-- `skills/`：技能定义与交接边界
-- `skills/references/`：编写标准、参考矩阵、加载映射
-- `rules/`：规则入口与规则覆盖层
-- `docs/`：安装、治理和工作流说明
-- `bin/`：CLI 与自动安装逻辑
+- 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)
+- GitHub Copilot: [docs/COPILOT-GUIDE.md](docs/COPILOT-GUIDE.md)
+- Cursor: [docs/CURSOR-GUIDE.md](docs/CURSOR-GUIDE.md)
+- Windsurf: [docs/WINDSURF-GUIDE.md](docs/WINDSURF-GUIDE.md)
+- Install / uninstall / update: [docs/install-uninstall-update-guide.md](docs/install-uninstall-update-guide.md)
 
-## 客户端安装指南
+## Docs
 
-具体的 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)
+- [docs/agent-governance-overview.md](docs/agent-governance-overview.md)
+
+## Conventions
+
+- `skills/` contains skill bodies.
+- `rules/` contains constraints and checks.
+- `docs/` stays short and practical.
+- Keep the homepage concise; move details into dedicated docs.