20d322be2f
借鉴 gstack 设计模式： - 8 条命令统一引入 Confusion Protocol（关键事实缺证据停止推理） - 假设验证路径 + 假设上限（≤5 条 active） - CWD 显式项目边界声明 - pos/uj 前置指令摘要（对标 gstack /context-restore） - ROADMAP 同步 + state_template 增强 - CHANGELOG v0.2.1
96 lines
3.9 KiB
Markdown
96 lines
3.9 KiB
Markdown
# 圆心商业化工作流（YxStack）变更记录
|
||
|
||
## v0.2.1 (2026-05-03)
|
||
|
||
### 新增
|
||
- **Confusion Protocol**：8 条命令统一引入假设暴露机制——关键事实缺证据时停止推理，转为追问
|
||
- **假设验证路径**：每个 active 假设必须附带可证伪的验证标准（一句话）
|
||
- **假设上限**：同时 active 假设 ≤ 5 条，超过必须先标记旧假设为 outdated
|
||
- **项目边界显式声明**：CWD 即 YxStack 项目根，不搜索父目录
|
||
- **前置摘要恢复**：pos.md 回溯 pfit 结论，uj.md 回溯 pfit + pos 结论
|
||
- `_timeline.jsonl` 新增 `conflict` 可选字段
|
||
- `templates/state_template.md` 增加验证标准列 + 假设状态取值规范
|
||
|
||
### 设计参考
|
||
- 对比 gstack（YC Garry Tan）的设计模式，基于上下文设计显式适配调整版：
|
||
- gstack 用 Confusion Protocol + 跨模型验证 → YxStack 用 Confusion Protocol + 假设验证路径 + 上限
|
||
- gstack 用 CWD 隐含边界 + /freeze 目录锁 → YxStack 用 CWD 显式声明
|
||
- gstack 用 checkpoint.md + timeline.jsonl 双轨 → YxStack 沿用 _state.md + _timeline.jsonl
|
||
- gstack 的 /context-restore 用 Summary + Remaining → YxStack 新增「前置指令摘要」
|
||
|
||
### 路线图同步
|
||
- v0.2.0 5 项 checklist 标记为已完成
|
||
- v0.2.1 新立项填补 v0.1.0 遗留缺口
|
||
|
||
## v0.2.0 (2026-05-03)
|
||
|
||
### 新增
|
||
- **多轮对话状态保持**：跨会话上下文记忆，产出递进而非重复
|
||
- `_state.md`（`.yxstack/` 下）：项目级状态快照，记录当前阶段、关键假设、决策链
|
||
- `_timeline.jsonl`（`.yxstack/` 下）：append-only 事件日志，作为事实来源，不可变
|
||
- 每条命令增加「第 0 步：加载项目状态」，执行前读取 `_state.md`
|
||
- 每条命令增加「更新项目状态」，执行后更新 `_state.md` + 追加 `_timeline.jsonl`
|
||
- `install.sh` 注入会话状态恢复逻辑：会话开始时自动读取 `_state.md`，给出欢迎摘要
|
||
- `templates/state_template.md`：模板与阶段流转参考
|
||
|
||
### 设计参考
|
||
- 借鉴 gstack 的 Context Recovery + append-only JSONL 模式
|
||
- 保留 YxStack 的 YAML frontmatter + Markdown 风格
|
||
|
||
### 路线图调整
|
||
- v0.2.0 改为「多轮对话状态保持」（原「指令深度增强」后移）
|
||
- v1.0.0 精简为「完整评测体系」（移除使用数据追踪）
|
||
|
||
## v0.1.2 (2026-05-03)
|
||
|
||
### 新增
|
||
- **自动升级**：Agent 会话启动时自动检查远端版本，有更新主动提醒
|
||
- `VERSION` 文件，记录当前版本号，作为升级对比基准
|
||
|
||
### 变更
|
||
- `install.sh` 安装/升级合二为一，跑两次效果相同
|
||
|
||
## v0.1.1 (2026-05-03)
|
||
|
||
### 新增
|
||
- **一行安装**：`install.sh` 脚本，自动克隆 + 配置 CODEBUDDY.md
|
||
- 智能检测：已配置过自动跳过，新用户自动创建配置文件
|
||
- README 简化为一行命令安装，降低新人上手门槛
|
||
|
||
## v0.1.0 (2026-05-03)
|
||
|
||
### 新增
|
||
- **知识沉淀机制**：每条指令执行完自动存档到 `.yxstack/`
|
||
- **回溯历史**：每条指令新增「第 0 步」——执行前先读项目历史记录
|
||
- **跨项目隔离**：不同项目的 `.yxstack/` 互不串读
|
||
- 存档格式：YAML frontmatter + 报告正文
|
||
- ROADMAP 加入 v0.1~v1.0 完整知识沉淀路线
|
||
|
||
### 变更
|
||
- 所有路径改为项目根目录相对路径（`.yxstack/`），不绑定特定项目结构
|
||
- README 新增知识沉淀机制说明
|
||
|
||
## v0.0.1 (2026-05-03)
|
||
|
||
### 新增
|
||
- 核心框架：README + 8 条命令执行模板
|
||
- 命令模板含 `核心追问清单 + 输出结构 + 常见误区`
|
||
- 全局 CODEBUDDY.md 集成机制
|
||
- ROADMAP 路线图
|
||
- MIT 开源协议
|
||
|
||
### 命令清单
|
||
| 指令 | 文件 |
|
||
|------|------|
|
||
| /pfit | commands/pfit.md |
|
||
| /pos | commands/pos.md |
|
||
| /uj | commands/uj.md |
|
||
| /prd | commands/prd.md |
|
||
| /money | commands/money.md |
|
||
| /gtm | commands/gtm.md |
|
||
| /metric | commands/metric.md |
|
||
| /comp | commands/comp.md |
|
||
|
||
### 维护方
|
||
- 筑基阁（开阳星）· 天机阁
|