AI Collaboration System / 智能协作系统
面向 Codex / Claude / Gemini 的终端多 Agent 协作编排框架。
本框架将真实开发流程中的规划、实现、审查与交付环节拆分至不同模型,并提供可观测、可回放、可降级的协作机制。
核心特性
- 主控优先:先规划再执行,避免单 Agent 盲目推进
- 配置驱动:模型与角色通过配置文件管理,无硬编码依赖
- 过程可见:基于 tmux 的协作模式支持实时交互、日志记录与会话回放
- 故障可控:针对命令不可用、权限受限、子 Agent 失败等场景提供显式降级策略
统一命令接口
项目采用单一命令入口:ai-collab
- 执行任务:
ai-collab "<task>" - 管理操作:
ai-collab <subcommand>(如init、status、config)
查看完整执行参数:
ai-collab run --help
安装方式
从源码安装
git clone https://github.com/skyhua0224/ai-collab.git
cd ai-collab
python3 -m pip install -e .
从 PyPI 安装
pip install ai-collab
快速开始
1. 初始化配置
ai-collab init
ai-collab status
2. 执行协作任务
ai-collab "设计并实现一个带鉴权的 REST API,并给出测试与发布建议"
3. 启用 tmux 可视化协作
ai-collab \
--provider codex \
--execution-mode tmux \
--tmux-target inline \
--tmux-prewarm-subagents \
"实现一个包含前端与后端的最小业务功能,并完成审查"
常用子命令
| 命令 | 功能说明 |
|---|---|
ai-collab init |
初始化配置文件模板 |
ai-collab status |
查看当前配置与 Agent 可用性状态 |
ai-collab detect |
检测协作需求并生成编排建议 |
ai-collab monitor |
手动启动 tmux 协作工作区 |
ai-collab config |
管理配置项 |
ai-collab select |
根据任务复杂度选择模型策略 |
可观测性与故障排查
日志目录结构
.ai-collab/logs/<session>/
常用排查命令
# 实时查看日志
tail -f .ai-collab/logs/<session>/*.log
# 检测任务编排建议(JSON 格式)
ai-collab detect "<task>" --output json
# 模拟执行(不实际运行)
ai-collab --dry-run --output json "<task>"
文档导航
开发与验证
# 运行测试
pytest -q
# 构建分发包
python3 -m build
# 验证分发包
python3 -m twine check dist/*
联系方式
- 📧 Email: dev@sky-hua.xyz
- 💬 Telegram: @skyhua
- 🐧 QQ: 2110591491
- 🔗 GitHub Issues: 提交 Issue
开源协议
Metadata
Release files for ai-collab 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ai_collab-0.1.4.tar.gz | 90.4 kB | Without provenance | Details for ai_collab-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ai_collab-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for ai_collab-0.1.4-py3-none-any.whl |
Total release size: 162.9 kB
Release files / ai_collab-0.1.4.tar.gz
| Download URL | ai_collab-0.1.4.tar.gz |
|---|---|
| Size | 90.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4fce54303c22ae5cfcbb5b35d8a6c124d89782054c527dd86aa50ed7282c785d
|
|
BLAKE2b-256 checksum How to use checksums |
048b15396d12b94493036fd7dcd0e582b19545da7a8050fe96fae15e22b8043d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / ai_collab-0.1.4-py3-none-any.whl
| Download URL | ai_collab-0.1.4-py3-none-any.whl |
|---|---|
| Size | 72.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eec5d0739240a34afd1911dc86b9171e4129e4b18de707955e5c15d97bdfae96
|
|
BLAKE2b-256 checksum How to use checksums |
db4348ef048838f40260721531b3e35e25380f4a7785230f9fc36446eff0cffc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for ai-collab 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.