4 posts tagged with "ClaudeCode"

OpenSpec 解决了一个我在 AI 编码里反复踩的坑：你和 AI 达成的共识，/clear 之后全没了。

• 问题本质：AI 在长对话中遗忘早期约束，清空上下文后设计共识归零
• OpenSpec 的解法：把共识写成结构化文档（proposal → spec → tasks），存进文件系统，不依赖对话记忆
• 核心流程：Propose → Apply → Archive，四步闭环，所有变更可追溯
• Delta Spec 机制：改需求不重写规格，用 ADDED/MODIFIED/REMOVED 增量描述，自动合并
• 和 Superpowers 的关系：OpenSpec 管"写什么"，Superpowers 管"怎么写"——一个定方向，一个定纪律
• 得物团队落地数据：10 天净增 25,546 行代码，研发提效 36%，关键是把规范写成 AI 的"可执行契约"

ClaudeCode 客户端消息流的有序性，本质上是 单写者 + 显式序号 + 受控并发 换来的工程纪律，不是靠运行时去猜消息该怎么排。

要点拆解：

1. 所有 stream 事件先汇入统一写入通道，由 序号 决定渲染顺序，不按到达时间。
2. 工具并发被框死在 读可并行、写必串行 的边界内。
3. UI 层只信任已经定序的快照，从不直接消费裸 SSE，否则就是乱序事故的源头。
4. 回合作为原子单位，失败整体丢弃，不修补半截回合。

理解这套规则，比追着 SDK 文档更有用。