75152c36c2
对照 gstack /learn + Operational Self-Improvement 设计： /learn 知识库： - 新增 commands/learn.md 指令模板 - 支持全类型外部材料摄入（PDF/DOCX/XLSX/CSV/HTML/图片等） - 8 模块 knowledge.md（行业背景/市场数据/竞品全景/目标用户/约束/假设/冲突/溯源） - 子命令：ingest、update、show、prune 自动发现： - 8 条命令更新项目状态追加 Operational Self-Improvement 段 - _timeline.jsonl 扩展 type/confidence/key 字段 - 写入标准：省时判断 + 非显而易见 + 置信度标注 8 命令第 0 步增强： - 加载知识库（learn/knowledge.md） - 加载近期学习（_timeline.jsonl 高置信度记录） ROADMAP 版本号重排 + state_template 增强 + install.sh 更新
122 lines
5.5 KiB
Markdown
122 lines
5.5 KiB
Markdown
# 圆心商业化工作流（YxStack）变更记录
|
||
|
||
## v0.3.0 (2026-05-03)
|
||
|
||
### 新增
|
||
- **/learn 指令**（commands/learn.md）：摄入外部业务材料，解析并汇总为结构化知识库
|
||
- 支持全类型材料（PDF/DOCX/XLSX/CSV/PPT/HTML/图片OCR/JSON）
|
||
- 按 8 模块归类（行业背景/市场数据/竞品全景/目标用户/关键约束/待验证假设/知识冲突/材料溯源）
|
||
- 子命令：`/learn <路径>`（摄入）、`update`（增量）、`show`（摘要）、`prune`（修剪）
|
||
- 对标 gstack /learn 的 prune 机制（过期检测 + 矛盾检测 + 置信度评估）
|
||
- **自动发现**（Operational Self-Improvement）：8 条命令执行完毕后自动记录高价值洞察
|
||
- 追加到 `_timeline.jsonl`，type: insight/decision/pitfall
|
||
- 判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
|
||
- 对标 gstack 各技能 SKILL.md 中的 Operational Self-Improvement 段
|
||
- **_timeline.jsonl 扩展**：新增 `type`/`confidence`/`key` 三个字段，支持学习记录去重和检索
|
||
- 8 条命令第 0 步增强：
|
||
- 「加载知识库」— 读取 learn/knowledge.md
|
||
- 「加载近期学习」— 检索 _timeline.jsonl 高置信度记录
|
||
- `templates/state_template.md` 新增 learn/knowledge.md 数据结构说明
|
||
|
||
### 设计参考
|
||
- gstack /learn 的 JSONL append-only + key+type 去重 + confidence 进化模型
|
||
- gstack 的 Operational Self-Improvement + Capture Learnings 双层写入机制
|
||
|
||
### 路线图调整
|
||
- ROADMAP v0.3.0 改为「/learn 知识库 + 自动发现」（原「指令深度增强」后移至 v0.4.0）
|
||
- 后续版本顺延：v0.4.0 指令深度增强 → v0.5.0 命令组合模式 → v0.6.0 场景自动识别 → v0.7.0 扩展生态 → v1.0.0 评测体系
|
||
|
||
## 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 |
|
||
|
||
### 维护方
|
||
- 筑基阁（开阳星）· 天机阁
|