skill support

zhonghui · zhonghui · commit 530a7ac4171a · 2026-04-11T00:55:25.000+08:00
diff --git a/README.en.md b/README.en.md
@@ -36,6 +36,16 @@ When using AI (Copilot, Claude, Cursor…) for development:
 
 ## Get Started in 30 Seconds
 
+### Option 1: Install via Agent Skills (Recommended)
+
+```bash
+npx skills add lordmos/dev-crew
+```
+
+> Compatible with 44+ AI platforms (Claude Code, GitHub Copilot, Cursor, Codex, etc.). Automatically installs the DevCrew protocol into your agent. See [skills.sh](https://skills.sh).
+
+### Option 2: Install via CLI
+
 ```bash
 npm install -g @lordmos/dev-crew
 cd your-project
@@ -186,23 +196,21 @@ crew agents  # List all available specialists
 ## Architecture
 
 ```
-┌─────────────────────────────────────────────┐
-│  Skills Layer                                │
-│  ┌──────────────┐  ┌──────────────────────┐ │
-│  │ CLI          │  │ MCP Server           │ │
-│  │ crew init    │  │ crew_init            │ │
-│  │ crew plan    │  │ crew_plan            │ │
-│  │ crew status  │  │ crew_status          │ │
-│  │ crew release │  │ crew_release         │ │
-│  └──────────────┘  └──────────────────────┘ │
-├─────────────────────────────────────────────┤
-│  Protocol Layer (core, zero tool dependency) │
-│  INSTRUCTIONS.md · PDEVI workflow ·          │
-│  File conventions · Communication rules      │
-└─────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────┐
+│  Access Layer                                        │
+│  ┌───────────┐ ┌──────────┐ ┌─────────────────────┐ │
+│  │ Agent     │ │ CLI      │ │ MCP Server          │ │
+│  │ Skills    │ │ crew *   │ │ crew_*              │ │
+│  │ SKILL.md  │ │          │ │                     │ │
+│  └───────────┘ └──────────┘ └─────────────────────┘ │
+├─────────────────────────────────────────────────────┤
+│  Protocol Layer (core, zero tool dependency)         │
+│  INSTRUCTIONS.md · PDEVI workflow ·                  │
+│  File conventions · Communication rules              │
+└─────────────────────────────────────────────────────┘
 ```
 
-> Even without CLI/MCP, manually placing `INSTRUCTIONS.md` works. Skills make the workflow more efficient.
+> Three access methods: install to any agent via `npx skills add`, operate via CLI, or call programmatically via MCP Server. Even without any tools, manually placing `INSTRUCTIONS.md` works.
 
 ---
 
diff --git a/README.md b/README.md
@@ -36,6 +36,16 @@
 
 ## 30 秒上手
 
+### 方式一：通过 Agent Skills 安装（推荐）
+
+```bash
+npx skills add lordmos/dev-crew
+```
+
+> 兼容 44+ AI 平台（Claude Code、GitHub Copilot、Cursor、Codex 等），自动将 DevCrew 协议安装到你的 Agent。详见 [skills.sh](https://skills.sh)。
+
+### 方式二：通过 CLI 安装
+
 ```bash
 npm install -g @lordmos/dev-crew
 cd your-project
@@ -186,22 +196,20 @@ crew agents  # 查看所有可用专家
 ## 架构
 
 ```
-┌─────────────────────────────────────────────┐
-│  Skills 层                                   │
-│  ┌──────────────┐  ┌──────────────────────┐ │
-│  │ CLI          │  │ MCP Server           │ │
-│  │ crew init    │  │ crew_init            │ │
-│  │ crew plan    │  │ crew_plan            │ │
-│  │ crew status  │  │ crew_status          │ │
-│  │ crew release │  │ crew_release         │ │
-│  └──────────────┘  └──────────────────────┘ │
-├─────────────────────────────────────────────┤
-│  协议层（核心，零工具依赖）                    │
-│  INSTRUCTIONS.md · PDEVI 工作流 · 文件约定    │
-└─────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────┐
+│  接入层                                              │
+│  ┌───────────┐ ┌──────────┐ ┌─────────────────────┐ │
+│  │ Agent     │ │ CLI      │ │ MCP Server          │ │
+│  │ Skills    │ │ crew *   │ │ crew_*              │ │
+│  │ SKILL.md  │ │          │ │                     │ │
+│  └───────────┘ └──────────┘ └─────────────────────┘ │
+├─────────────────────────────────────────────────────┤
+│  协议层（核心，零工具依赖）                            │
+│  INSTRUCTIONS.md · PDEVI 工作流 · 文件约定             │
+└─────────────────────────────────────────────────────┘
 ```
 
-> 即使不装 CLI/MCP，手动放入 `INSTRUCTIONS.md` 也能工作。Skills 让流程更高效。
+> 三种接入方式：通过 `npx skills add` 安装到任意 Agent、通过 CLI 命令操作、通过 MCP Server 程序化调用。即使不装任何工具，手动放入 `INSTRUCTIONS.md` 也能工作。
 
 ---
 
diff --git a/docs/en/index.md b/docs/en/index.md
@@ -34,8 +34,8 @@ features:
     title: Files as Memory
     details: Each agent maintains independent long-term memory and work logs — context auto-recovers across sessions.
   - icon: ⚡
-    title: Skills + MCP
-    details: Built-in skills (init, plan, status, release) accessible via CLI and MCP Server — AI agents can call them directly.
+    title: Skills Ecosystem
+    details: One-command install to 44+ AI platforms via npx skills add. Also supports CLI and MCP Server for direct invocation.
 ---
 
 <div class="home-examples">
diff --git a/docs/en/quick-start.md b/docs/en/quick-start.md
@@ -2,6 +2,18 @@
 
 ## Install
 
+### Option 1: Install via Agent Skills (Recommended)
+
+```bash
+npx skills add lordmos/dev-crew
+```
+
+Automatically installs the DevCrew protocol into your AI agent (supports Claude Code, GitHub Copilot, Cursor, Codex, and 44+ platforms).
+
+> See [skills.sh](https://skills.sh)
+
+### Option 2: Install via CLI
+
 ```bash
 npm install -g @lordmos/dev-crew
 ```
diff --git a/docs/index.md b/docs/index.md
@@ -34,8 +34,8 @@ features:
     title: 文件即记忆
     details: 每个 Agent 维护独立的长期记忆和工作记录，跨会话自动恢复上下文。
   - icon: ⚡
-    title: Skills + MCP
-    details: 提供 init / plan / status / release 等 Skill，CLI 和 MCP Server 双通道，AI Agent 可直接调用。
+    title: Skills 生态
+    details: 通过 npx skills add 一键安装到 44+ AI 平台，同时支持 CLI 和 MCP Server 双通道调用。
 ---
 
 <div class="home-examples">
diff --git a/docs/quick-start.md b/docs/quick-start.md
@@ -2,6 +2,18 @@
 
 ## 安装
 
+### 方式一：通过 Agent Skills 安装（推荐）
+
+```bash
+npx skills add lordmos/dev-crew
+```
+
+自动将 DevCrew 协议安装到你的 AI Agent（支持 Claude Code、GitHub Copilot、Cursor、Codex 等 44+ 平台）。
+
+> 详见 [skills.sh](https://skills.sh)
+
+### 方式二：通过 CLI 安装
+
 ```bash
 npm install -g @lordmos/dev-crew
 ```
diff --git a/skills/crew-agents/SKILL.md b/skills/crew-agents/SKILL.md
@@ -0,0 +1,59 @@
+---
+name: crew:agents
+user-invocable: true
+description: List available domain specialists that can be activated for the DevCrew team — covering game dev, security, DevOps, AI/ML, and more.
+metadata:
+  author: lordmos
+  version: 0.5.0
+---
+
+# crew agents — 列出可用领域专家
+
+查看所有可用的领域专家（Domain Specialists），了解每位专家的名称、所属领域和适用的 PDEVI 阶段。
+
+## 何时使用
+
+- 用户问"有哪些专家"、"list agents"、"谁能帮忙"
+- 需要为特定领域（如安全、游戏开发）激活专家
+- 配置 `dev-crew.yaml` 前了解选项
+
+## 使用方法
+
+### CLI
+
+```bash
+npx @lordmos/dev-crew agents
+```
+
+### MCP Tool
+
+```
+crew_agents()
+```
+
+## 输出内容
+
+按领域分组展示所有可用专家：
+
+- **专家 ID**：用于 `dev-crew.yaml` 配置
+- **专家名称**：角色描述
+- **适用阶段**：在 PDEVI 的哪些阶段参与
+
+## 激活专家
+
+在 `dev-crew.yaml` 中添加专家 ID：
+
+```yaml
+specialists:
+  - game-designer
+  - security-engineer
+  - devops-engineer
+```
+
+激活后，PjM 会在对应 PDEVI 阶段自动调度专家参与协作。
+
+## 可用领域
+
+> 游戏开发（8）· UI/UX（3）· 安全（1）· DevOps（3）· 测试（3）· 工程（5）· 数据（2）· AI/ML（1）· Web3（1）· 空间计算（2）
+
+共 **29 位领域专家**覆盖 10 个领域。
diff --git a/skills/crew-checkpoint/SKILL.md b/skills/crew-checkpoint/SKILL.md
@@ -0,0 +1,72 @@
+---
+name: crew:checkpoint
+user-invocable: true
+description: Run a phase audit and consistency check on the current change. Validates all checklist items before advancing to the next PDEVI phase.
+metadata:
+  author: lordmos
+  version: 0.5.0
+---
+
+# crew checkpoint — 阶段审计与一致性检查
+
+对当前活跃变更执行阶段审计，检查所有审计项是否通过，确保一致性后推进到下一阶段。
+
+## 何时使用
+
+- 每个 PDEVI 阶段结束时**必须执行**
+- 用户说"做个检查点"、"检查一下"、"run checkpoint"
+- 需要验证当前阶段的产出质量
+
+## 使用方法
+
+### CLI
+
+```bash
+npx @lordmos/dev-crew checkpoint [change-name]
+```
+
+不指定变更名称时，自动选择第一个活跃变更。
+
+### MCP Tool
+
+```
+crew_checkpoint(cwd: string, change?: string)
+```
+
+## 审计清单
+
+### Plan 阶段
+- [ ] proposal.md 包含目标、需求、验收标准
+- [ ] 验收标准为 checklist 格式（`- [ ]`）
+- [ ] 命名一致性检查
+- [ ] 用户已确认（`plan_confirmed: true`）
+
+### Design 阶段
+- [ ] design.md 引用 proposal.md（文件指针，非重复内容）
+- [ ] 技术决策附带理由
+- [ ] 任务分解为 checklist 格式
+- [ ] 任务分解覆盖所有验收标准
+- [ ] 命名与 proposal 一致
+
+### Execute 阶段
+- [ ] impl-log.md 所有任务标记 `[x]`
+- [ ] 每条完成记录附带文件路径和改动摘要
+- [ ] 代码改动与 design.md 任务一一对应
+- [ ] 无未完成的 design.md checklist 项
+
+### Verify 阶段
+- [ ] test-report.md 逐条检查验收标准
+- [ ] review-report.md 完成代码审查
+- [ ] 缺陷记录附带回退建议
+- [ ] 用户已确认（`verify_confirmed: true`）
+
+## 一致性审计
+
+除阶段审计外，还检查：
+- blockers.md 是否有 `[OPEN]` 状态的阻断项
+- resume.md 是否存在且格式正确
+- 文件是否超过 200 行（建议拆分或使用文件指针）
+
+## 输出
+
+审计报告包含 `[PASS]` / `[TODO]` 标记、一致性检查结果、记忆同步提醒和下一阶段建议。
diff --git a/skills/crew-init/SKILL.md b/skills/crew-init/SKILL.md
@@ -0,0 +1,77 @@
+---
+name: crew:init
+user-invocable: true
+description: Initialize a DevCrew workspace — creates INSTRUCTIONS.md, project config, agent memory files, and document templates for AI team orchestration.
+metadata:
+  author: lordmos
+  version: 0.5.0
+---
+
+# crew init — 初始化 DevCrew 工作区
+
+在当前项目中创建 DevCrew 多 Agent 协作所需的完整工作区结构。
+
+## 何时使用
+
+- 从零开始一个新项目，需要 AI 团队协作
+- 为已有项目引入 DevCrew 协议
+- 用户说"初始化"、"设置 DevCrew"、"set up dev-crew"
+
+## 使用方法
+
+### CLI（推荐）
+
+```bash
+npx @lordmos/dev-crew init [options]
+```
+
+**参数：**
+
+| 选项 | 说明 | 示例 |
+|------|------|------|
+| `--platform, -p` | 目标 AI 平台，自动写入平台指令文件 | `--platform copilot` |
+| `--name` | 项目名称（默认从 package.json 或目录名推断） | `--name my-app` |
+| `--no-gitignore` | 不修改 .gitignore | |
+
+**平台选项：**
+
+```bash
+crew init -p copilot    # → .github/copilot-instructions.md
+crew init -p cursor     # → .cursorrules
+crew init -p claude     # → CLAUDE.md
+crew init -p copilot cursor  # 多平台
+```
+
+### MCP Tool
+
+```
+crew_init(cwd: string, name?: string, platform?: string[], gitignore?: boolean)
+```
+
+## 创建的文件结构
+
+```
+your-project/
+├── INSTRUCTIONS.md         ← AI 行为指令（核心协议文件）
+├── dev-crew.yaml           ← 项目配置
+└── dev-crew/
+    ├── resume.md           ← PjM 编排状态
+    ├── blockers.md         ← 问题与决策跟踪
+    ├── specs/              ← 共享规约
+    ├── memory/             ← Agent 长期记忆
+    │   ├── pdm.md
+    │   ├── architect.md
+    │   ├── implementer.md
+    │   ├── tester.md
+    │   └── reviewer.md
+    └── templates/          ← 文档格式模板
+        ├── proposal.md
+        ├── design.md
+        ├── impl-log.md
+        ├── test-report.md
+        └── review-report.md
+```
+
+## 幂等性
+
+重复执行不会覆盖已有文件，只补全缺失部分。
diff --git a/skills/crew-plan/SKILL.md b/skills/crew-plan/SKILL.md
diff --git a/skills/crew-release/SKILL.md b/skills/crew-release/SKILL.md
diff --git a/skills/crew-status/SKILL.md b/skills/crew-status/SKILL.md
diff --git a/skills/dev-crew/SKILL.md b/skills/dev-crew/SKILL.md
