@lordmos/dev-crew 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OrcheSpec Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,214 @@
+> **语言 / Language**: [简体中文](README.md) · **English**
+
+<div align="center">
+  <img src="docs/public/logo.svg" alt="DevCrew" width="180" />
+
+  # DevCrew
+
+  **Give AI a collaboration protocol. Let it work like a real team.**
+
+  *帮你做好 harness！*
+
+  [![npm version](https://img.shields.io/npm/v/@lordmos/devcrew?style=flat-square&color=CDFE00)](https://www.npmjs.com/package/@lordmos/devcrew)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+  [![Node.js](https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
+  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-CDFE00.svg?style=flat-square)](https://github.com/lordmos/dev-crew/pulls)
+
+</div>
+
+---
+
+## The Problem
+
+When using AI (Copilot, Claude, Cursor…) for development:
+
+| Problem | What happens |
+|---------|-------------|
+| 🧠 **No memory** | Switch conversations, AI forgets everything |
+| 🎭 **No division of labor** | AI plays PM + architect + dev + tester simultaneously |
+| 🎯 **Goes off track** | Drifts from goals with no checkpoints to correct course |
+| 🔍 **Quality blind spots** | No review process — bugs and tech debt accumulate silently |
+| ❓ **No starting point** | Don't know how to orchestrate AI collaboration |
+
+**Root cause**: AI lacks a persistent collaboration protocol. DevCrew is that protocol.
+
+---
+
+## Get Started in 30 Seconds
+
+```bash
+npm install -g @lordmos/devcrew
+cd your-project
+crew init
+```
+
+Three steps — your project now has a **ready-to-use 6-person AI dev team** + **29 optional domain specialists**, fully auto-orchestrated.
+
+Works with **GitHub Copilot · Claude · ChatGPT · Cursor** and any AI platform.
+
+---
+
+## How It Works
+
+```
+You: I need to add auth middleware to the API
+
+AI:  📋 Creating change add-api-auth, mode: Standard
+     Plan — Requirements:
+     - Goal: Add JWT auth to all /api/ routes
+     - Acceptance: ☐ No token → 401  ☐ Expired token → 401
+     Please confirm.
+
+You: Confirmed
+
+AI:  Design → Execute → Verify — All passed. Please confirm acceptance.
+
+You: Confirmed
+
+AI:  ✅ Change add-api-auth complete.
+```
+
+**You only confirmed twice** (requirements + results). Everything else was automatic.
+
+---
+
+## What `crew init` Creates
+
+```
+your-project/
+├── INSTRUCTIONS.md    ← AI behavior instructions (core file)
+├── devcrew.yaml       ← Project config (modes, specialists)
+└── devcrew/
+    └── specs/         ← Shared specifications
+```
+
+AI reads `INSTRUCTIONS.md` and automatically assembles the team, following the PDEVI workflow.
+
+---
+
+## Core Concepts
+
+### PDEVI Workflow
+
+```mermaid
+flowchart LR
+    P["Plan"] --> D["Design"]
+    D --> E["Execute"]
+    E --> V["Verify"]
+    V -->|Fail| I["Iterate"]
+    I -->|Design issue| D
+    I -->|Implementation issue| E
+    V -->|Pass| Done["✅ Done"]
+```
+
+Three modes for every scenario:
+
+| Mode | Flow | Best for |
+|------|------|----------|
+| **Standard** | P → D → E → V → I | New features, refactoring |
+| **Express** | P → E → V | Bug fixes |
+| **Prototype** | P → D → E | Quick prototyping |
+
+### Built-in Team (6 Roles)
+
+| Role | Responsibility |
+|------|---------------|
+| 🎯 **PjM** Project Manager | Orchestration, mode inference, stage transitions |
+| 📋 **PdM** Product Manager | Requirements analysis, PRD import, acceptance criteria |
+| 🏗️ **Architect** | Tech decisions, task decomposition, dependency analysis |
+| 💻 **Implementer** | Code generation, refactoring, dependency management |
+| 🧪 **Tester** | Test execution, acceptance checks, coverage |
+| 👀 **Reviewer** | Code review, security scanning, best practices |
+
+Role switching is fully automatic — no manual assignment needed.
+
+### Domain Specialists (29)
+
+Beyond the core team, **29 domain specialists** across 10 fields, activated on demand:
+
+> 🎮 Game Dev (8) · 🎨 UI/UX (3) · 🔒 Security (1) · ⚙️ DevOps (3) · 🧪 Testing (3) · 💻 Engineering (5) · 📊 Data (2) · 🤖 AI/ML (1) · 🌐 Web3 (1) · 🥽 Spatial Computing (2)
+
+```yaml
+# devcrew.yaml
+specialists:
+  - game-designer
+  - security-engineer
+```
+
+```bash
+crew agents  # List all available specialists
+```
+
+> See the full [Specialist Directory](agents/README.md)
+
+---
+
+## Skill Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/crew:init` | Initialize workspace |
+| `/crew:plan <name>` | Create a change and start working |
+| `/crew:status` | Check current progress |
+| `/crew:explore` | Discuss / analyze (no code changes) |
+| `/crew:release` | Archive completed changes |
+
+> Natural language works too — "show me the progress" = `/crew:status`
+
+---
+
+## Use Cases
+
+| Scenario | You say | DevCrew does |
+|----------|---------|-------------|
+| Greenfield | "I have an idea, build from scratch" | Init → guide requirements → Standard |
+| Existing PRD | "Here's the PRD, execute it" | Import PRD → refine → Standard |
+| Mid-project | "Code exists, help me continue" | Scan code → establish baseline → Standard |
+| Brainstorm | "Let's discuss the approach" | `/crew:explore` (no code changes) |
+| Bug fix | "There's a bug, fix it fast" | Express mode |
+| Refactor | "This code needs refactoring" | Standard (full workflow) |
+| Prototype | "Build a quick prototype first" | Prototype mode |
+| Learn codebase | "Help me understand this code" | `/crew:explore` (code analysis) |
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│  Tool Layer                                  │
+│  ┌──────────────┐  ┌──────────────────────┐ │
+│  │ CLI          │  │ Agent Skill          │ │
+│  │ crew init    │  │ INSTRUCTIONS.md      │ │
+│  │ crew agents  │  │ /crew: commands      │ │
+│  └──────────────┘  └──────────────────────┘ │
+├─────────────────────────────────────────────┤
+│  Protocol Layer (core, zero tool dependency) │
+│  Directory conventions · File formats ·      │
+│  PDEVI workflow · Communication rules        │
+└─────────────────────────────────────────────┘
+```
+
+> Even without CLI, manually placing `INSTRUCTIONS.md` works. CLI just makes it easier.
+
+---
+
+## Documentation
+
+| Doc | Description |
+|-----|-------------|
+| [User Manual](docs/USER-MANUAL.md) | Detailed guide for 8 scenarios |
+| [Best Practices](docs/examples/) | Scenario walkthrough examples |
+| [Specialists](agents/README.md) | 29 specialists · 10 domains |
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)
+
+## Credits
+
+Domain specialists adapted from the [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) project.

package/README.md

@@ -0,0 +1,213 @@
+> **语言 / Language**: **简体中文** · [English](README.en.md)
+
+<div align="center">
+  <img src="docs/public/logo.svg" alt="DevCrew" width="180" />
+
+  # DevCrew
+
+  **给 AI 一套协作协议，让它像真正的团队一样工作。**
+
+  *帮你做好 harness！*
+
+  [![npm version](https://img.shields.io/npm/v/@lordmos/devcrew?style=flat-square&color=CDFE00)](https://www.npmjs.com/package/@lordmos/devcrew)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
+  [![Node.js](https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
+  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-CDFE00.svg?style=flat-square)](https://github.com/lordmos/dev-crew/pulls)
+
+</div>
+
+---
+
+## 痛点
+
+用 AI（Copilot、Claude、Cursor…）辅助开发时，你是否遇到过：
+
+| 问题 | 表现 |
+|------|------|
+| 🧠 **无记忆** | 换个对话窗口，AI 忘了之前做了什么 |
+| 🎭 **无分工** | AI 同时充当 PM + 架构师 + 开发 + 测试，顾此失彼 |
+| 🎯 **会跑偏** | 做着做着偏离目标，没有检查点纠正 |
+| 🔍 **质量盲区** | 没有审查环节，bug 和技术债悄悄积累 |
+| ❓ **不知从何开始** | 面对新项目，不知道如何编排 AI 协作 |
+
+**根因**：AI 缺少一套持久化的协作协议。DevCrew 就是那套协议。
+
+---
+
+## 30 秒上手
+
+```bash
+npm install -g @lordmos/devcrew
+cd your-project
+crew init
+```
+
+三步完成——你的项目现在拥有一个**开箱即用的 6 人 AI 开发团队** + **29 位可选领域专家**，全部自动编排。
+
+适用于 **GitHub Copilot · Claude · ChatGPT · Cursor** 及任何 AI 平台。
+
+---
+
+## 它是怎么工作的
+
+```
+你: 我要给 API 加认证中间件
+
+AI: 📋 创建变更 add-api-auth，模式: Standard
+    Plan — 需求整理:
+    - 目标: 为所有 /api/ 路由添加 JWT 认证
+    - 验收标准: ☐ 未携带 token 返回 401  ☐ 过期 token 返回 401
+    请确认。
+
+你: 确认
+
+AI: Design → Execute → Verify — 全部通过。请确认验收。
+
+你: 确认
+
+AI: ✅ 变更 add-api-auth 完成。
+```
+
+**你只确认了两次**（需求 + 结果），其余全部自动。
+
+---
+
+## `crew init` 做了什么
+
+```
+your-project/
+├── INSTRUCTIONS.md    ← AI 行为指令（核心文件）
+├── devcrew.yaml       ← 项目配置（模式、专家选择）
+└── devcrew/
+    └── specs/         ← 共享规约
+```
+
+AI 读取 `INSTRUCTIONS.md` 后，自动建立团队，按 PDEVI 流程协作。
+
+---
+
+## 核心概念
+
+### PDEVI 工作流
+
+```mermaid
+flowchart LR
+    P["Plan"] --> D["Design"]
+    D --> E["Execute"]
+    E --> V["Verify"]
+    V -->|不通过| I["Iterate"]
+    I -->|方案问题| D
+    I -->|实现问题| E
+    V -->|通过| Done["✅ 完成"]
+```
+
+三种模式，覆盖所有场景：
+
+| 模式 | 流程 | 适用 |
+|------|------|------|
+| **Standard** | P → D → E → V → I | 新功能、重构 |
+| **Express** | P → E → V | Bug 修复 |
+| **Prototype** | P → D → E | 快速原型 |
+
+### 内建团队（6 人）
+
+| 角色 | 职责 |
+|------|------|
+| 🎯 **PjM** 项目经理 | 调度编排、模式推断、阶段推进 |
+| 📋 **PdM** 产品经理 | 需求梳理、PRD 导入、验收标准 |
+| 🏗️ **Architect** 架构师 | 技术选型、任务分解、依赖分析 |
+| 💻 **Implementer** 开发 | 代码生成、重构、依赖安装 |
+| 🧪 **Tester** 测试 | 测试执行、验收检查、覆盖率 |
+| 👀 **Reviewer** 审查 | 规范检查、安全扫描、最佳实践 |
+
+角色切换完全自动，无需手动分配。
+
+### 领域专家（29 位）
+
+核心团队之外，**29 位领域专家**覆盖 10 个领域，按需激活：
+
+> 🎮 游戏开发（8）· 🎨 UI/UX（3）· 🔒 安全（1）· ⚙️ DevOps（3）· 🧪 测试（3）· 💻 工程（5）· 📊 数据（2）· 🤖 AI/ML（1）· 🌐 Web3（1）· 🥽 空间计算（2）
+
+```yaml
+# devcrew.yaml
+specialists:
+  - game-designer
+  - security-engineer
+```
+
+```bash
+crew agents  # 查看所有可用专家
+```
+
+> 完整列表见 [领域专家目录](agents/README.md)
+
+---
+
+## Skill 指令
+
+| 指令 | 用途 |
+|------|------|
+| `/crew:init` | 初始化工作区 |
+| `/crew:plan <名称>` | 创建变更并开始工作 |
+| `/crew:status` | 查看当前进度 |
+| `/crew:explore` | 讨论 / 分析（不改代码） |
+| `/crew:release` | 归档已完成变更 |
+
+> 自然语言同样有效——"帮我看看进度" = `/crew:status`
+
+---
+
+## 使用场景
+
+| 场景 | 你说 | DevCrew 做 |
+|------|------|------------|
+| 从零开始 | "有个想法，从零构建" | 初始化 → 引导需求 → Standard |
+| 已有 PRD | "需求文档在这，执行吧" | 导入 PRD → 提炼 → Standard |
+| 中途接入 | "代码已有，帮我续上" | 扫描代码 → 建基线 → Standard |
+| 头脑风暴 | "讨论一下方案" | `/crew:explore`（不改代码） |
+| Bug 修复 | "有个 bug，快修" | Express 模式 |
+| 代码重构 | "这段代码要重构" | Standard 完整流程 |
+| 快速原型 | "先做个原型验证" | Prototype 模式 |
+| 学习代码库 | "帮我理解这段代码" | `/crew:explore`（分析代码） |
+
+---
+
+## 架构
+
+```
+┌─────────────────────────────────────────────┐
+│  工具层                                      │
+│  ┌──────────────┐  ┌──────────────────────┐ │
+│  │ CLI          │  │ Agent Skill          │ │
+│  │ crew init    │  │ INSTRUCTIONS.md      │ │
+│  │ crew agents  │  │ /crew: 指令          │ │
+│  └──────────────┘  └──────────────────────┘ │
+├─────────────────────────────────────────────┤
+│  协议层（核心，零工具依赖）                    │
+│  目录约定 · 文件格式 · PDEVI · 通信规则       │
+└─────────────────────────────────────────────┘
+```
+
+> 即使不装 CLI，手动放入 `INSTRUCTIONS.md` 也能工作。CLI 只是让流程更方便。
+
+---
+
+## 文档
+
+| 文档 | 说明 |
+|------|------|
+| [用户手册](docs/USER-MANUAL.md) | 8 种场景详细指南 |
+| [最佳实践](docs/examples/) | 场景串联示例 |
+| [领域专家](agents/README.md) | 29 位专家 · 10 个领域 |
+
+## 贡献
+
+欢迎参与！详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+## 许可证
+
+[MIT](LICENSE)
+
+## 致谢
+
+领域专家部分基于 [agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) 项目改编。

package/agents/README.md

@@ -0,0 +1,136 @@
+# 领域专家目录
+
+> 共 **29** 位专家 · **10** 个领域包
+
+DevCrew 内建 6 个核心角色（PjM/PdM/Architect/Implementer/Tester/Reviewer）。领域专家是**可选的补充角色**——为特定项目类型提供专业知识，增强核心团队的领域深度。
+
+## 使用方式
+
+```yaml
+# devcrew.yaml
+specialists:
+  - game-designer      # 按需激活
+  - ui-designer
+  - security-engineer
+```
+
+PjM 在 `/crew:init` 时读取配置，加载对应专家 prompt，在 PDEVI 的相关阶段自动参与。每个专家独立，可自由组合。
+
+---
+
+## 专家速查表
+
+### 🎮 游戏开发（8）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| 游戏设计师 | [`game-designer.md`](game-designer.md) | P·D·V | GDD、游戏循环、经济平衡 |
+| 关卡设计师 | [`level-designer.md`](level-designer.md) | D·E·V | 关卡节奏、空间叙事、难度曲线 |
+| 叙事设计师 | [`narrative-designer.md`](narrative-designer.md) | P·D·V | 剧情架构、对话系统、分支叙事 |
+| 技术美术 | [`technical-artist.md`](technical-artist.md) | D·E·V | Shader、性能美术、管线工具 |
+| 游戏音频工程师 | [`game-audio-engineer.md`](game-audio-engineer.md) | D·E·V | 自适应音频、Wwise/FMOD、空间音效 |
+| Unity 专家 | [`unity-specialist.md`](unity-specialist.md) | D·E·V | DOTS/ECS、URP/HDRP、Addressables |
+| Godot 专家 | [`godot-specialist.md`](godot-specialist.md) | D·E·V | GDScript/C#、Scene 树、信号系统 |
+| Unreal 专家 | [`unreal-specialist.md`](unreal-specialist.md) | D·E·V | Blueprint/C++、GAS、Nanite/Lumen |
+
+### 🎨 UI/UX 设计（3）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| UI 设计师 | [`ui-designer.md`](ui-designer.md) | D·E·V | 设计系统、组件库、响应式 |
+| UX 架构师 | [`ux-architect.md`](ux-architect.md) | P·D·V | 信息架构、用户流程、可用性 |
+| UX 研究员 | [`ux-researcher.md`](ux-researcher.md) | P·D·V | 用研方法、可用性测试、数据洞察 |
+
+### 🔒 安全（1）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| 安全工程师 | [`security-engineer.md`](security-engineer.md) | D·E·V | 威胁建模、OWASP、安全审查 |
+
+### ⚙️ DevOps & 可靠性（3）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| DevOps 工程师 | [`devops-engineer.md`](devops-engineer.md) | D·E·V | CI/CD、容器化、IaC、监控 |
+| SRE | [`sre.md`](sre.md) | D·E·V | SLO/错误预算、混沌工程、容量规划 |
+| 事件响应指挥官 | [`incident-response-commander.md`](incident-response-commander.md) | E·V | 事件分级、根因分析、Runbook |
+
+### 🧪 测试 & QA（3）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| API 测试专家 | [`api-tester.md`](api-tester.md) | D·E·V | 契约测试、自动化、性能基线 |
+| 性能工程师 | [`performance-engineer.md`](performance-engineer.md) | D·E·V | 负载测试、性能基线、瓶颈分析 |
+| 无障碍审计师 | [`accessibility-auditor.md`](accessibility-auditor.md) | D·E·V | WCAG、键盘/屏幕阅读器、对比度 |
+
+### 💻 工程专项（5）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| 前端专家 | [`frontend-specialist.md`](frontend-specialist.md) | D·E·V | React/Vue、状态管理、性能优化 |
+| 后端架构师 | [`backend-architect.md`](backend-architect.md) | D·E·V | API 设计、数据建模、分布式架构 |
+| 移动开发专家 | [`mobile-developer.md`](mobile-developer.md) | D·E·V | iOS/Android/跨平台、离线优先 |
+| 嵌入式工程师 | [`embedded-engineer.md`](embedded-engineer.md) | D·E·V | 固件/RTOS、外设驱动、低功耗 |
+| 技术写作专家 | [`technical-writer.md`](technical-writer.md) | P·D·V | API 文档、用户指南、术语一致性 |
+
+### 📊 数据 & 数据库（2）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| 数据工程师 | [`data-engineer.md`](data-engineer.md) | D·E·V | ETL/ELT、数据管道、数据质量 |
+| 数据库专家 | [`database-specialist.md`](database-specialist.md) | D·E·V | 数据建模、查询优化、高可用 |
+
+### 🤖 AI/ML（1）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| AI 工程师 | [`ai-engineer.md`](ai-engineer.md) | D·E·V | 模型训练、RAG/LLM、MLOps |
+
+### 🌐 Web3（1）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| Solidity 工程师 | [`solidity-engineer.md`](solidity-engineer.md) | D·E·V | 智能合约、Gas 优化、安全审计 |
+
+### 🥽 空间计算（2）
+
+| 专家 | 文件 | 阶段 | 核心能力 |
+|------|------|------|---------|
+| visionOS 工程师 | [`visionos-engineer.md`](visionos-engineer.md) | D·E·V | RealityKit、SwiftUI、空间交互 |
+| XR 开发专家 | [`xr-developer.md`](xr-developer.md) | D·E·V | Unity/WebXR、VR/AR/MR、多平台 |
+
+---
+
+## 推荐领域包
+
+| 场景 | 推荐专家组合 | YAML 示例 |
+|------|------------|----------|
+| **Web 全栈** | frontend + backend + ui-designer + security | `[frontend-specialist, backend-architect, ui-designer, security-engineer]` |
+| **游戏 (Unity)** | game-designer + unity + level-designer + ui | `[game-designer, unity-specialist, level-designer, ui-designer]` |
+| **移动应用** | mobile + ui-designer + ux-architect + api-tester | `[mobile-developer, ui-designer, ux-architect, api-tester]` |
+| **云原生/微服务** | backend + devops + sre + security | `[backend-architect, devops-engineer, sre, security-engineer]` |
+| **数据平台** | data-engineer + database + backend | `[data-engineer, database-specialist, backend-architect]` |
+| **AI 应用** | ai-engineer + backend + performance | `[ai-engineer, backend-architect, performance-engineer]` |
+| **嵌入式/IoT** | embedded + security + technical-writer | `[embedded-engineer, security-engineer, technical-writer]` |
+| **安全合规** | security + accessibility + api-tester + sre | `[security-engineer, accessibility-auditor, api-tester, sre]` |
+
+---
+
+## 专家与核心团队的关系
+
+```mermaid
+graph TD
+    PjM["PjM 调度"]
+    Core["核心团队<br>PdM · Architect · Implementer · Tester · Reviewer"]
+    Spec["领域专家<br>（按配置激活）"]
+    
+    PjM -->|编排| Core
+    PjM -->|按阶段调度| Spec
+    Spec -->|领域知识补充| Core
+```
+
+**规则**：
+- 领域专家**补充**核心角色，不替代
+- PjM 在 PDEVI 对应阶段调度专家参与
+- 专家产出合并到 proposal.md / design.md（不创建独立文件）
+- 未配置专家时，核心团队独立完成所有工作（零影响）

package/agents/accessibility-auditor.md

@@ -0,0 +1,48 @@
+---
+name: 无障碍审计师
+category: testing
+stages: [design, execute, verify]
+source: agency-agents-zh/testing/testing-accessibility-auditor.md
+---
+
+# 领域专家：无障碍审计师
+
+你是一位资深无障碍审计师。你确保产品对所有用户可用——包括视障、听障、运动障碍和认知障碍用户。你以 WCAG 标准为基准，以用户体验为目标。
+
+## 在 PDEVI 中的职责
+
+### Design 阶段 → 补充 design.md
+
+**无障碍标准**
+| 维度 | 目标等级 | 关键要求 |
+|------|---------|---------|
+| 感知性 | WCAG AA | 文本替代、字幕、对比度 ≥4.5:1 |
+| 可操作性 | WCAG AA | 键盘可达、触控 ≥44px、无闪烁 |
+| 可理解性 | WCAG AA | 清晰标签、可预测行为、错误建议 |
+| 健壮性 | WCAG AA | 语义 HTML、ARIA 正确使用 |
+
+### Execute 阶段 → 辅助 Implementer
+
+- 审查 HTML 语义结构（heading 层级/landmark/列表）
+- 验证 ARIA 属性使用正确性（role/state/property）
+- 检查键盘导航流（Tab 顺序/焦点管理/快捷键）
+- 验证屏幕阅读器兼容性（VoiceOver/NVDA/JAWS）
+- 检查颜色对比度和色盲友好性
+
+### Verify 阶段 → 补充验证标准
+
+- [ ] 自动化扫描通过（axe-core/Lighthouse 0 错误）？
+- [ ] 纯键盘可完成所有核心任务？
+- [ ] 屏幕阅读器朗读内容有意义？
+- [ ] 色彩对比度 ≥4.5:1（正常文本）/ ≥3:1（大文本）？
+- [ ] 焦点指示器清晰可见？
+- [ ] 动画可关闭（prefers-reduced-motion）？
+- [ ] 表单错误提示关联到对应字段？
+
+## 关键规则
+
+1. **语义 HTML 优先于 ARIA**：能用原生元素就不加 ARIA
+2. **键盘是底线**：如果键盘不能操作，就是不可访问的
+3. **自动化只发现 30% 问题**：自动工具 + 手动测试 + 辅助技术实测
+4. **对比度不是建议是要求**：低于标准 = 不达标
+5. **无障碍是功能不是优化**：和其他功能一样必须测试和维护

package/agents/ai-engineer.md

@@ -0,0 +1,52 @@
+---
+name: AI 工程师
+category: ai-ml
+stages: [design, execute, verify]
+source: agency-agents-zh/engineering/engineering-ai-engineer.md
+---
+
+# 领域专家：AI 工程师
+
+你是一位资深 AI/ML 工程师。你将机器学习模型从实验带到生产——涵盖模型选型、训练管道、推理优化、LLM 应用和 MLOps。
+
+## 在 PDEVI 中的职责
+
+### Design 阶段 → 补充 design.md
+
+**AI/ML 架构**
+| 维度 | 决策 | 理由 |
+|------|------|------|
+| 问题类型 | [分类/生成/检索/推荐] | [业务目标] |
+| 模型方案 | [预训练微调/RAG/从头训练/API 调用] | [数据量/精度] |
+| 框架 | [PyTorch/TensorFlow/HuggingFace/LangChain] | [生态/需求] |
+| 推理部署 | [API 服务/边端/批处理] | [延迟/成本] |
+| 评估指标 | [准确率/F1/BLEU/自定义] | [业务含义] |
+
+**LLM 应用设计**（如适用）
+- Prompt 工程策略（Few-shot/CoT/Tool-use）
+- RAG 架构（向量库选型/分块策略/检索排序）
+- 安全护栏（内容过滤/幻觉检测/成本控制）
+
+### Execute 阶段 → 辅助 Implementer
+
+- 搭建训练/微调管道和实验追踪（MLflow/W&B）
+- 实现特征工程和数据预处理管道
+- 构建推理服务（模型服务化/缓存/批处理）
+- 实现 RAG 系统（嵌入/索引/检索/生成）
+- 编写评估套件和 A/B 测试框架
+
+### Verify 阶段 → 补充验证标准
+
+- [ ] 模型指标达到基线（离线评估通过）？
+- [ ] 推理延迟和吞吐量达标？
+- [ ] 模型大小和内存在部署环境预算内？
+- [ ] 边界情况和对抗样本测试通过？
+- [ ] 模型版本化和回滚机制就绪？
+
+## 关键规则
+
+1. **先基线后优化**：用最简单的方案建立基线，再迭代
+2. **数据质量 > 模型复杂度**：垃圾数据无法用更大的模型拯救
+3. **实验可复现**：固定种子/版本化数据/记录超参数
+4. **LLM 不是万能的**：能用规则解决的不用模型
+5. **成本要可控**：监控 Token 消耗/GPU 时间，设置预算告警