claude_dev
03a3d9ae5e
docs(v0.5): 添加 Gitea 协作流程设计
...
- 添加 Issue 结构(工作清单模式)
- 添加 6 步工作流程
- 添加 Comment 标记约定
- 添加流程图
- 添加偏差处理机制
- 简化感知机制:Sub 完成标记 → Main 主动读取 Gitea
2026-07-01 20:32:18 +08:00
claude_dev
cc3d9e380d
docs: 简化 v0.5 设计文档第 3.6 节 - 验收机制
...
- 保留三向一致性检查概念图
- 简化检查方法,只保留核心三向检查
- 明确偏差处理:发现偏差后重新进入 Superpowers 五阶段工作流
- 删除详细的偏差处理策略表格,使内容更简洁
2026-07-01 20:02:41 +08:00
claude_dev
47df41043b
docs: 重写 v0.5 设计文档为完整一致方案
...
- 去除历史调研痕迹(videotext、GLM-5.2、CCB、SendMessage等)
- 删除 v0.4 vs v0.5 对比表
- 统一术语(writing-plans、executing-plans 等)
- 将版本历史移至附录
- 聚焦最终方案描述,不再描述演化过程
新结构:
1. 系统架构(架构概览、核心设计原则、标准化工作流)
2. 角色定义(Main Agent、Execute/Review/Test Sub Agents)
3. 编排机制(策略、Linus三问、需求讨论、上下文隔离、编排模式)
4. 工作流程(标准五阶段、任务类型示例)
5. 实施指南(环境配置、编排脚本、Gitea协作)
6. 附录(术语表、版本历史、参考资料)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 19:37:25 +08:00
claude_dev
9c6eaa2ebd
docs: 添加 v0.5 动态编排设计文档整合版
...
- 整合 06 文档,消除重复内容
- 重组结构:概述→设计精髓→角色→编排→Superpowers→工作流→实施→对比
- 清理历史调研痕迹
- 添加清晰的设计叙述主线
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 19:32:31 +08:00
claude_dev
abb50cbce5
docs(v0.5.1): 补充 Linus 三问 + Superpowers 五技能体系
...
- 添加 Linus 三问工程审慎决策框架到决策部分
- 对齐 Superpowers 五技能标准工作流
- writing-plans → executing-plans → requesting-code-review → systematic-debugging → finishing-a-development-branch
- 更新能力对照表和工作流图
- 添加版本变更说明附录
2026-07-01 19:05:28 +08:00
claude_dev
2195bb4542
docs: 更新 v0.5 设计文档 - 明确 Main Agent 需求讨论职责
...
## 核心变更
1. **需求讨论职责**
- Main Agent 承担与用户进行需求讨论的职责
- 明确使用 deep-interview skill 进行系统化需求提取
- 核心循环: ASK -> LISTEN -> WRITE -> DEEPEN -> REPEAT
2. **验收整合职责**
- Main Agent 使用 CODE-REVIEW skill 进行代码审查验收
- 检查逻辑/安全/性能/测试/错误处理
3. **工作流更新**
- 所有工作流示例添加需求讨论阶段
- 简单任务: AskUserQuestion 快速确认
- 中等/复杂任务: deep-interview 深度讨论
## 新增内容
- 需求讨论触发条件 (needsDiscussion)
- Main Agent 核心能力表
- 完整的 CLAUDE.md 配置模板
- 与 v0.4 的详细对比
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 16:59:04 +08:00
claude_dev
70c140f5a7
docs: 添加 v0.5 部署指南和初始化脚本
...
- 完整的部署步骤文档
- 环境配置说明
- 工作流使用指南
- 故障排查说明
- 自动化初始化脚本
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 08:49:50 +08:00
claude_dev
7d6b82efd2
docs: 更新 Web 访问配置 - 添加认证和可写模式
...
- ttyd 添加基本认证 (sanguo:sanguo2024)
- 添加 -W 参数启用可写模式
- 更新安全配置说明
- 添加密码修改说明
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 08:24:08 +08:00
claude_dev
449eec9df7
docs: 添加 v0.5 动态编排设计
...
- 创建 Main + Sub Agent 动态编排方案
- Main Agent 作为编排者,根据任务需要动态安排 Sub Agents
- Sub Agents 分为 Execute、Review、Test 专业角色
- 不是固化工作流,而是 Main 根据需求灵活调整
- 添加上下文隔离原则
- 创建工作流脚本模板
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-07-01 08:23:58 +08:00
claude_dev
a8ac23f699
docs: 更新 v0.4 最终状态 - 设计和基础设施完成
...
完成项目:
✅ 文档: 设计、快速参考、示例工作流
✅ 项目结构: 三个项目目录 + CLAUDE.md
✅ 角色 Skills: architect-role, backend-dev, frontend-dev
✅ 配置脚本: tmux, 启动, 消息队列, 测试
✅ 环境验证: 18/18 测试通过
待用户操作:
- 启动 tmux 环境
- 在各 pane 启动 Claude Code
- 测试 SendMessage 协作
- (可选) 启动 ttyd Web 访问
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-30 22:38:02 +08:00
claude_dev
5d85c080e4
docs: 添加示例工作流文档
...
新增 docs/05-example-workflows.md:
- 工作流 1: 实现用户认证功能 (完整流程)
- 工作流 2: 代码审查流程
- 工作流 3: Bug 修复流程
- 工作流 4: 性能优化流程
- SendMessage 最佳实践
- 常用命令参考
测试脚本 (外部):
- ~/.claude/messages/sanguo/test-sanguo-env.sh
- 环境测试: 18/18 通过 ✅
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-30 22:37:44 +08:00
claude_dev
0187809460
docs: 完成 v0.4 基础设施实施
...
新增文件:
- docs/04-quick-reference.md - 快速参考文档
创建的系统文件 (外部):
- ~/.tmux-sanguo.conf - tmux 三实例配置
- ~/.claude/messages/sanguo/message.sh - 消息队列系统
- ~/.claude/messages/sanguo/start-sanguo-env.sh - 启动脚本
- ~/.claude/projects/sanguo-{main,backend,frontend}/.claude/CLAUDE.md - 角色定义
- ~/.claude/skills/{architect-role,backend-dev,frontend-dev}/SKILL.md - 角色 skills
完成状态:
✅ 项目目录、CLAUDE.md、角色 Skills、tmux 配置、消息队列、启动脚本、快速参考
⚠️ 待启动: tmux 会话、Claude Code 实例、ttyd Web
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-30 22:35:39 +08:00
claude_dev
0829b34b92
docs: 更新 v0.4 设计 - SendMessage 验证结果和实施状态
...
验证结果:
- SendMessage 支持跨会话通信 (v2.1.166+)
- 发现安全限制: 无权限传递、拒绝中继请求、Auto 模式阻止
- 已完成: 项目目录、CLAUDE.md 文件、角色 Skills 创建
- 待实施: tmux 配置、ttyd Web 启动
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-30 22:31:59 +08:00
claude_dev
eda99309ed
docs: 添加 v0.4 设计文档 - 三实例方案,所有 Agent 共享 Superpowers skills
...
- 架构:三个 Claude Code 实例(架构师 + 后端 + 前端)
- 共享:所有实例共享 ~/.claude/skills/ Superpowers skills
- 角色:通过 CLAUDE.md 定义清晰的角色隔离
- 协作:通过 SendMessage 跨实例通信
- 验证:需要验证 SendMessage 跨实例能力
- 配置:详细的 tmux 三 pane 配置和启动流程
2026-06-30 22:27:17 +08:00
claude_dev
1c8a4ff95c
docs: 添加 v0.3 设计文档 - 采用 Claude Code 内置多 Agent 能力,移除 CCB 层
...
- 移除 CCB 桥接层(Codex/Gemini CLI 不兼容 GLM-5.2)
- 采用 Claude Code 内置 Agent 工具(Explore、Plan、通用 agents)
- Skills 替代 Workflow 编排
- 简化为三层架构:Claude Code → Skills → GLM-5.2
- 统一使用 GLM-5.2 Anthropic 兼容端点
2026-06-30 20:03:07 +08:00
claude_dev
a1972c7ff9
docs: 更新 v0.2 设计文档中所有旧端点为 GLM Coding Plan 端点
...
- 统一使用 https://api.z.ai/api/coding/paas/v4
- 移除所有旧的 api.zhipuai.cn 和 open.bigmodel.cn 引用
2026-06-30 08:18:42 +08:00
claude_dev
6d6ef3c319
docs: 更新 GLM Coding Plan 端点和兼容性说明
...
- 修正端点为: https://api.z.ai/api/coding/paas/v4
- 验证 curl 直接调用成功
- 记录 Codex/Gemini CLI 不兼容问题
- 推荐直接使用 Claude Code + GLM-5.2
2026-06-30 08:07:09 +08:00
claude_dev
5810deb6ec
docs: 更新 v0.2 设计 - 修正 GLM-5.2 端点,gotty 替换为 ttyd
...
- GLM-5.2 端点修正为: https://open.bigmodel.cn/api/paas/v4
- gotty 替换为 ttyd (C 实现,性能更好)
- 验证端点正确,API Key 有效但余额不足
- 更新实施状态: 环境准备完成
2026-06-30 08:03:41 +08:00
claude_dev
b23773e9ad
docs: 更新 v0.2 设计文档实施状态
...
- 添加第13节:实施状态
- 标记已完成组件:Go, CCB, Codex CLI, Gemini CLI, tmux
- 记录待解决问题:gotty 安装失败、GLM-5.2 API 连接问题
- 记录待验证项和替代方案
2026-06-29 23:50:33 +08:00
claude_dev
371f7a7a88
docs: 添加v0.2设计方案(基于videotext调研,集成GLM-5.2和Web访问)
2026-06-29 22:26:43 +08:00
claude_dev
b730e28b1a
docs: 添加tmux web访问方案调研
2026-06-29 22:17:24 +08:00
claude_dev
1cdaba9c85
docs: 添加GLM-5.2配置方案调研
2026-06-29 20:09:58 +08:00
claude_dev
95555e2828
docs: 添加videotext方案调查报告
2026-06-29 19:50:18 +08:00
claude_dev
37579ebdcd
refactor: 重新组织文档结构
...
- docs/PRD.md - 产品需求文档(移到根目录)
- docs/design/01-design-v0.1.md - 系统设计文档(移到子目录)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-29 08:25:00 +08:00
claude_dev
d811a5e212
refactor: 将设计文档移到 docs 目录
...
- 移动 design/01-design-v0.1.md → docs/01-design-v0.1.md
- 删除空的 design 目录
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-29 08:21:47 +08:00
claude_dev
37ba76f92e
docs: v0.1 PRD 和设计文档
...
- docs/01-PRD-v0.1.md: 产品需求文档
- 项目定位:多 AI 桥接协作系统
- 用户场景:研发提效、通用编排、特定场景
- 核心功能:桥接通信、角色分工、三层架构、成本追踪
- design/01-design-v0.1.md: 系统设计文档
- 架构设计:规则层、能力层、通信层分离
- 核心组件:桥接器、任务编排器、成本追踪器
- 协作模式:串行审查、对抗辩论、三方共识
- 数据库设计:tasks、costs、collaborations 表
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com >
2026-06-29 07:11:42 +08:00