Metadata-Version: 2.4
Name: opencode-collaboration
Version: 2.2.10
Summary: 双Agent协作框架 - 产品经理与开发的分离式协作工具
Author-email: liuzhen <dev@opencode.ai>
License: MIT
Project-URL: Homepage, https://gitee.com/zhang-xiuqin01/dual-agent-collaboration-system
Project-URL: Repository, https://gitee.com/zhang-xiuqin01/dual-agent-collaboration-system
Project-URL: Issues, https://gitee.com/zhang-xiuqin01/dual-agent-collaboration-system/issues
Project-URL: Changelog, https://gitee.com/zhang-xiuqin01/dual-agent-collaboration-system/-/raw/main/docs/00-changelog/CHANGELOG.md
Keywords: collaboration,agent,project-management,cli
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: jinja2>=3.0
Requires-Dist: rich>=12.0
Requires-Dist: inquirer>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: flake8>=6.0; extra == "dev"

# 双 Agent 协作开发系统

基于 OpenCode 的双 Agent 协作框架，实现产品经理与开发的分离式协作。

---

## 安装

```bash
pip install opencode-collaboration
```

---

## 快速开始

### 1. 初始化项目

```bash
# 创建新项目
oc-collab init myproject
cd myproject
```

### 2. 创建需求文档

编辑 `docs/01-requirements/requirements_v*.md` 文件，定义需求。

### 3. 评审并签署

```bash
# Agent 2 (开发) 评审需求
oc-collab review requirements --comment "技术方案可行"

# Agent 1 (产品) 签署确认
oc-collab signoff requirements --comment "同意实现"
```

### 4. 推进到下一阶段

```bash
# 推进到设计阶段
oc-collab advance -p design
```

---

## 常用命令

| 命令 | 说明 |
|------|------|
| `oc-collab status` | 查看项目状态和待办摘要 (v2.2.3) |
| `oc-collab .a` | 显示当前关联的项目信息 (v2.2.3) |
| `oc-collab todowrite` | 创建待办任务 (v2.2.3) |
| `oc-collab todoedit` | 编辑待办任务 (v2.2.3) |
| `oc-collab todo` | 查看待办事项 |
| `oc-collab todowrite --auto-check` | 创建TODO，自动检查参数并携带上下文 (v2.2.6) |
| `oc-collab skill search --keywords <kw>` | 搜索Skill文档 (v2.2.6) |
| `oc-collab skill slice <skill>` | 查看Skill特定切片 (v2.2.6) |
| `oc-collab skill enforce` | 检查Skill加载状态 (v2.2.6) |
| `oc-collab advance -p <phase>` | 推进到指定阶段 |
| `oc-collab signoff <stage>` | 签署确认 |
| `oc-collab history` | 查看协作历史 |
| `oc-collab compliance check` | 合规检查 (v2.2.2) |
| `oc-collab git sync` | Git同步 (v2.2.2) |
| `oc-collab rules init [--force]` | 初始化框架规则 (v2.2.8) |
| `oc-collab rules status` | 检查规则初始化状态 (v2.2.8) |
| `oc-collab rules init --auto-load` | 自动加载默认规则 (v2.2.9) |
| `oc-collab compliance check` | 合规检查 (v2.2.2) |
| `oc-collab compliance report` | 生成合规报告 (v2.2.9) |
| `oc-collab compliance violations` | 查看违规记录 (v2.2.9) |
| `oc-collab deploy check-docs` | 检查部署文档同步 (v2.2.9) |
| `oc-collab deploy sync-docs` | 同步部署文档 (v2.2.9) |
| `oc-collab webhook notify test` | 测试Webhook通知功能 (v2.2.8) |

---

## 协作流程

```
需求评审 → 设计评审 → 开发完成 → 测试通过 → 部署上线
    ↓          ↓           ↓          ↓         ↓
   签署       签署         签署       签署      完成

每个阶段必须双方签署后才能进入下一阶段
```

---

## 阶段说明

| 阶段 | 说明 |
|------|------|
| `requirements` | 需求评审阶段 |
| `design` | 设计评审阶段 |
| `development` | 开发阶段 |
| `testing` | 测试阶段 |
| `deployment` | 部署阶段 |

---

## 项目结构

```
myproject/
├── docs/
│   ├── 01-requirements/   # 需求文档
│   ├── 02-design/         # 设计文档
│   └── 03-test/           # 测试报告
├── state/
│   └── project_state.yaml # 项目状态
└── src/                   # 源代码
```

---

## 版本历史

| 版本 | 日期 | 功能 |
|------|------|------|
| v2.2.9 | 2026-02-14 | StateNotifier集成（todowrite/signoff/phase_advance）、自动Bug检测、Agent Compliance CLI准入、规则自动加载 |
| v2.2.8 | 2026-02-13 | Webhook基础架构：EventDispatcher、StateNotifier骨架、HMAC验证 |
| v2.2.7 | 2026-02-10 | Skill内容准确性测试、覆盖率统计、事件监听与崩溃恢复 |
| v2.2.6 | 2026-02-09 | 智能辅助：todowrite自动检查、TODO上下文携带、冲突检测；Skill关键词检索、切片查看、强制查找 |
| v2.2.5 | 2026-02-09 | 文件Owner机制、signoff修复、版本结束后需求分析流程、评审机制优化 |
| v2.2.4 | 2026-02-08 | Skill强制加载检查、Git提交前签署验证、需求文档完整性检查 |
| v2.2.3 | 2026-02-08 | Agent体验优化：`.a`项目信息、任务同步、状态摘要 |
| v2.2.2 | 2026-02-07 | 协作规范强制执行、Git同步集成 |
| v2.2.1 | 2026-02-07 | 双代理认知免疫系统、动态Checklist |
| v2.2.0 | 2026-02-06 | 初始版本 |

---

## 详细文档

完整使用指南请参见项目 GitHub 仓库：
https://github.com/legoland01/dual-agent-collaboration-system

---

**Author**: liuzhen
**License**: MIT
