tengfeizhao1219/dsh-ai-collab

README 摘要

ai-collab · AI 协作开发框架插件 把「 文件即通信 」的多角色 AI 协作机制做成通用插件：任何软件项目，通过本插件一键初始化约定文件，任何 AI 客户端都能驱动 AI 多角色协作（O 主控 + 专业角色）完成项目。 - 机制来源 ：真实项目实践「AI 情报官」多角色协作机制 v1.0（源自 One News 多会话协作框架），已验证可支撑一个完整项目的 AI 协作开发。 - 核心洞察 ：AI 会失忆、会并行互相覆盖、会自作主张、会编造——文件机制解决这一切。AI 的"云端记忆"只带你是谁， 文件机制才带项目进行到哪 。 - 不绑定任何 AI 客户端 ：载体是文件，WorkBuddy / CodeBuddy / DeepSeek Harness / Claude 桌面端等均适用。 快速开始（3 步） 已有项目想切换协作模式：在项目根目录跑 init.py 生成约定文件（目录非空时先 --dir 指定子目录或手动放置模板）， 或直接把 templates/ 下的模板复制进项目根目录并替换 {{变量}} 。 包结构 机制速览（详见 docs/MECHANISM.md） 要素 要点 文件即通信 约定文件是唯一事实来源；新会话读文件 100% 继承 角色体系 O 主控持有全局，子 Agent 临时扮演 I/A/P/D/Q/K，身份由角色卡权威定义 约定文件 CONTEXT / ROLE CARDS / TASK BOARD / RELAY / COMMLOG / COLLABORATION / NAVIGATION Git 纪律 改前 pull --rebase，改后立即 commit，小步快推 任务流转 📋 待认领 → 🔄 进行中 → ✅ 完成 / 🚫 阻塞；交付交接包；3 分支意图识别 关口检查 阶段级全 ✅ 由 O 检查，通过才放行下一阶段 owner 参与 只拍板 + 给凭证；AI 显式请求资源，绝不编造 会话继承 新会话按序读五件套 → 汇报继承摘要 → 等待派发 同步 Git 60s 守护 + Notion 60s 幂等同步（可选） 常见问题 Q: 我的 AI 客户端不支持自定义技能，能用吗？ 能。核心用法就是把 SESSION BOOT.md 的接棒提示词粘贴进新会话——任何能读文件、能 git 的 AI 都能按机制运行。 Q: 云端会话和本地会话能并行吗？ 能。两边都遵守 Git 纪律（改前拉、改后推、认领前看状态），各自改不同文件时无冲突。 Q: 子 Agent 怎么派？ O 用 SESSION BOOT.md 中的「子 Agent 身份注入」模板开头，子 Agent 启动读角色卡获得身份，交付写回约定文件。 Q: 需要一直开着同步守护吗？ 不必。守护只是让多端实时一致；单人单机时手动 commit+push 即可（机制不依赖守…

分类