用途:把需求与约束整理成可评审、可落地的技术设计文档,包括技术方案、架构设计、接口规范、实施方案、ADR 与 arc42 文档;也支持整合用户上传的现有设计稿、接口表、日志与历史文档。触发条件为用户要求编写上述文档或要求整合既有材料。
主要能力与输出:推荐结构含背景与目标、功能与非功能需求、总体架构(组件、数据流、关键交互)、关键设计细节(存储、缓存、一致性、幂等、容错)、API 设计、数据模型、安全与合规、发布与运维(部署、监控、回滚、容量)、风险与备选方案、开发计划(里程碑、验收)。输出落盘至 /workspace/output/,必选 output/design.md,可选 output/adr/(多份 ADR)与 output/api.md;另可生成 output/notes.md 记录未决问题、假设与引用索引。
使用方式:先澄清目标、成功指标、性能成本时间合规安全等约束、读者(架构评审/研发实现/运维交付/管理层)与输出格式(Markdown 必选,可再导出 docx)。随后逐个上传资料到 input/:curl -sS -F "file=@/path/to/file" "http://opencode-bridge:8000/file/{user}" -H "Authorization: Bearer $OPENCODE_BRIDGE_TOKEN"。再以结构化指令委托 OpenCode:curl -sS -X POST "http://opencode-bridge:8000/task/{user}" -H "Content-Type: application/json" -H "Authorization: Bearer $OPENCODE_BRIDGE_TOKEN" -d '{"message":"<技术设计结构化指令,引用 input/...>"}'。回传时先给关键架构决策、主要风险与备选方案,再给 design.md、ADR、API 文档;修订按章节编号逐条进行,保留决策可追溯性。
约定与限制:bridge 地址为 http://opencode-bridge:8000,鉴权用 Authorization: Bearer $OPENCODE_BRIDGE_TOKEN;{user} 在私聊取 open_id,群共享用 chat_id。涉及大量材料整理、生成目录结构与长文时交由 OpenCode 执行。具体定价、平台兼容范围与效果指标暂未提供。