feat: v0.2.0 多轮对话状态保持

- 新增 templates/state_template.md — _state.md 和 _timeline.jsonl 模板
- 8 条命令模板增加"第 0 步:加载项目状态"和"更新项目状态"规则
- install.sh 注入会话状态恢复逻辑(CODEBUDDY.md)
- ROADMAP 调整为 v0.2.0=状态保持,v1.0.0=评测体系

借鉴 gstack 的 Context Recovery + append-only JSONL 模式:
_timeline.jsonl 只追加不修改作为事实来源,_state.md 做当前快照
This commit is contained in:
开阳星
2026-05-03 03:26:46 +08:00
parent 3bfe1a7cbe
commit ce844cdf51
11 changed files with 321 additions and 17 deletions

View File

@@ -3,7 +3,16 @@
## 命令定位
明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。
## 第 0 步:回溯历史
## 第 0 步:加载项目状态
执行本指令前,先读取项目根目录下的 `.yxstack/_state.md`(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径,则使用自定义路径):
- 了解项目当前所处的 YxStack 阶段exploration/validation/positioning/pricing/growth
- 确认已有的关键假设和决策
- 检查是否有与本次指令相关的待处理项
- 如果 _state.md 不存在,说明这是项目首次使用 YxStack
然后按原有规则检查历史记录:
执行本指令前,先检查当前项目根目录下的 `.yxstack/` 目录(如果项目 CODEBUDDY.md
自定义了 YxStack 存档路径则使用自定义路径查找近期同指令pos的历史记录
@@ -61,3 +70,20 @@ status: draft # draft → validated → outdated
---
```
## 更新项目状态
### 追加事件日志
`.yxstack/_timeline.jsonl` 追加一行:
```json
{"skill":"pos","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设(有则填,无则留空)","decision":"本次关键决策(有则填,无则留空)"}
```
### 更新状态快照
更新 `.yxstack/_state.md`
- 如果本次执行推动了项目阶段前进,更新 `phase` 字段
- 本次新增的假设 → 写入「关键假设」表status: active
- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
- 如有重要决策 → 追加「决策链」
- 更新「待处理项」:标记已完成的,新增下一步建议
- 如果 _state.md 不存在,按模板创建(参考 templates/state_template.md