feat: v0.3.0 — /learn 知识库 + 自动发现

对照 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 更新
docs: ROADMAP v0.2.1 checklist 标记完成，v0.3.0 设为当前
2026-05-03 05:08:39 +08:00 · 2026-05-03 04:21:45 +08:00 · 2026-05-03 04:19:55 +08:00 · 2026-05-03 03:27:47 +08:00 · 2026-05-03 03:26:46 +08:00 · 2026-05-03 01:49:35 +08:00
15 changed files with 1388 additions and 17 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,101 @@
 # 圆心商业化工作流（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)

 ### 新增
--- a/README.md
+++ b/README.md
@@ -33,20 +33,49 @@ YxStack 是一套**业务产品工作流规范**，用于指导产品经理和

 每个指令的详细执行模板见 `commands/` 目录。

+## 知识沉淀机制
+
+YxStack 支持跨会话知识积累——每次指令执行完毕，报告自动存档到项目本地。
+
+**默认存档路径**：`{项目根目录}/.yxstack/{指令名}-{日期}-{摘要}.md`
+
+**存档格式**：YAML frontmatter + 报告正文，与星图知识库格式兼容。
+
+**存档内容示例**：
+```
+.yxstack/
+├── pfit-2026-05-03-药企科普合规路径.md
+├── comp-2026-06-15-竞品分析.md
+└── prd-2026-07-01-MVP定义.md
+```
+
+**跨项目隔离**：不同项目的 `.yxstack/` 互不串读，确保问答不污染。
+
+**自定义路径**：如果项目 CODEBUDDY.md 中定义了 `yxstack_archive_path`，优先使用自定义路径。
+
 ## 安装使用

-将本仓库克隆至 `~/.codebuddy/yxstack/`，并在 `~/.codebuddy/CODEBUDDY.md` 中引用：
+同事推荐？一行命令搞定：

-```markdown
-# 工作流规范
-采用 **圆心商业化工作流（YxStack）** 作为全局默认规范。
-
-使用指令时，需读取 `~/.codebuddy/yxstack/commands/{command}.md`
-获取完整执行模板，并按模板中的 Checklist 执行。
-
-完整定义见 `~/.codebuddy/yxstack/README.md`。
+```bash
+git clone http://82.157.208.197:3000/qiukai/yxstack-skill.git ~/.codebuddy/yxstack/ && bash ~/.codebuddy/yxstack/install.sh
 ```

+脚本会自动：
+1. 下载 YxStack 模板到 `~/.codebuddy/yxstack/`
+2. 在 `~/.codebuddy/CODEBUDDY.md` 中添加 YxStack 配置（已配过则跳过）
+
+装完直接在你的 CodeBuddy Code 里输入 `/pfit`、`/pos` 等指令即可使用。
+
+**升级**：安装和升级是同一条命令，再跑一次即可：
+```bash
+bash ~/.codebuddy/yxstack/install.sh
+```
+
+## 自动升级
+
+安装后，Agent 每次会话启动时自动检查远端版本号。如果发现新版本，会主动提醒你升级，确认后自动执行。
+
 ## 项目负责人

 - 维护：筑基阁（开阳星）
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -6,36 +6,109 @@
 - [x] 8 条命令执行模板（Checklist + 输出结构 + 常见误区）
 - [x] 全局 CODEBUDDY.md 集成机制

-## v0.1.0 — 指令深度增强
+## v0.1.2 — 自动升级（已完成）
+
+- [x] Agent 会话启动时自动检查远端版本号
+- [x] 发现新版本主动提醒用户升级
+- [x] `VERSION` 文件 + git tag 双重版本标记
+- [x] install.sh 兼做安装和升级
+
+## v0.1.1 — 一键安装（已完成）
+
+- [x] `install.sh` 安装脚本，一行命令完成全部配置
+- [x] README 简化为一行安装指令
+- [x] 智能检测：已有配置跳过、新用户自动创建 CODEBUDDY.md
+
+## v0.1.0 — 知识沉淀机制
+
+### 项目级痕迹库（已实现）
+- [x] 每条指令执行完毕自动存档到 `{项目根目录}/.yxstack/`
+- [x] 统一格式：YAML frontmatter + 报告正文
+- [x] 文件命名：`{指令}-{日期}-{摘要}.md`
+
+### 跨项目隔离（已实现）
+- [x] 不同项目的 yxstack 历史互不串读
+- [x] 执行指令时模型只读取当前项目的 yxstack/ 目录
+
+### 回溯与进化（已实现）
+- [x] 每条指令新增「第 0 步：回溯历史」——执行前先读同项目同类历史记录
+- [x] 每条指令新增「存档规则」——执行完按规范存档
+- [x] 报告标注与历史结论的一致性/矛盾/更新
+
+### 待完成（→ 下移到 v0.2.1）
+- [ ] 知识冲突自动检测——新结论与历史矛盾时主动提醒
+- [ ] 指令执行时自动识别项目边界，找到对应 yxstack/ 目录
+
+## v0.2.0 — 多轮对话状态保持（已完成）
+
+- [x] 跨会话上下文记忆——今天跑了 `/prd`，三天后跑 `/money` 时能回溯 PRD 的假设
+- [x] 对话产出递进检测——同项目多轮对话之间，产出应递进而非重复
+- [x] 项目级全局状态文件——`{项目根目录}/.yxstack/_state.md`，记录当前阶段、关键假设、决策链
+- [x] 会话开始时自动读取 `_state.md`，结束会话前自动更新
+- [x] 状态过期/矛盾标注——假设发生变化时，标记旧假设为 outdated 并记录变化原因
+
+## v0.2.1 — 漏洞修补（已完成）
+
+借鉴 gstack（YC CEO Garry Tan 开源的 AI 工程团队工作流）的设计模式，补齐遗留项。
+
+- [x] **Confusion Protocol** — 8 条命令统一引入假设暴露机制：关键事实缺证据时停止推理，转为追问
+- [x] **假设验证路径** — 每个 active 假设必须附带可证伪的验证标准
+- [x] **假设上限** — 同时 active 假设 ≤ 5 条，超过必须先标记旧假设为 outdated
+- [x] **项目边界显式声明** — CWD 即 YxStack 项目根，不搜索父目录（对标 gstack CWD + /freeze 模式）
+- [x] **前置摘要恢复** — pos.md 回溯 pfit 结论，uj.md 回溯 pfit + pos 结论（对标 gstack /context-restore 的 Summary + Remaining 结构）
+- [x] ROADMAP 同步 — v0.2.0 标记完成，v0.1.0 遗留项下移
+
+## v0.3.0 — /learn 知识库 + 自动发现 ← 当前
+
+借鉴 gstack 的 /learn + 自动发现机制，建立项目级外部知识摄入和专业洞察自动沉淀能力。
+
+### /learn 知识库
+- [ ] `commands/learn.md` — 新指令模板：摄入外部材料（全类型），解析并汇总到 `knowledge.md`
+- [ ] `.yxstack/learn/knowledge.md` — 单文件知识库（行业背景/市场数据/竞品/用户/约束/假设/冲突/溯源 8 模块）
+- [ ] `/learn update` — 增量检测新材料
+- [ ] `/learn prune` — 修剪过期/矛盾知识（对标 gstack 的冲突检测 + 文件存在性检测）
+
+### 自动发现
+- [ ] 8 条命令「更新项目状态」统一追加自动发现段（Operational Self-Improvement）
+- [ ] `_timeline.jsonl` 扩展 type/confidence/key 三个字段
+- [ ] 自动发现写入标准：省时判断 + 非显而易见 + 置信度标注
+
+### 8 命令集成
+- [ ] 第 0 步增加「加载知识库」段落（读取 learn/knowledge.md）
+- [ ] 第 0 步增加「加载近期学习」段落（读取 _timeline.jsonl 高置信度记录）
+
+## v0.4.0 — 指令深度增强

 - [ ] 为每条命令增加典型场景案例库
 - [ ] 细化各阶段追问权重与优先级
 - [ ] 增加"未完待续"处理策略（信息不足时怎么收口）

-## v0.2.0 — 命令组合模式
+## v0.5.0 — 命令组合模式

 - [ ] `/prd + /pfit` = 完整产品评审流程
 - [ ] `/pos + /comp` = 市场定位全景分析
 - [ ] `/uj + /metric` = 用户体验指标体系
 - [ ] 组合命令的输出融合规范

-## v0.3.0 — 场景自动识别
+## v0.6.0 — 场景自动识别

 - [ ] 模型无需用户显式使用 `/xxx`，自动识别当前场景
 - [ ] 自动匹配最相关的 1-2 条指令
 - [ ] 渐进式引导——先判断在哪个阶段，再切入对应清单

-## v0.4.0 — 扩展生态
+## v0.7.0 — 扩展生态

 - [ ] 支持行业定制模板（SaaS、电商、医疗、教育等）
 - [ ] 集成到 Hookify 体系——通过 prompt 钩子自动匹配场景
 - [ ] 社区贡献机制——开放命令模板 Pull Request 流程

-## v1.0.0 — 产品级可靠
+## v1.0.0 — 完整评测体系

- [ ] 完整评测体系（每个指令的一致性、准确性、覆盖度）
- [ ] 使用数据追踪与持续优化
- [ ] 多轮对话状态保持与上下文管理
+- [ ] 一致性评测——同一场景多轮输出是否自洽
+- [ ] 准确性评测——标准场景下输出是否命中关键点
+- [ ] 覆盖度评测——每条命令的 Checklist 是否覆盖边界情况
+- [ ] 评测集构建——10-20 个标准场景 + 期望输出标准
+- [ ] 发版前自动评测流程

 ---

--- a/1
+++ b/1
@@ -0,0 +1 @@
+v0.3.0
--- a/commands/comp.md
+++ b/commands/comp.md
@@ -4,6 +4,44 @@
 从商业模式、价值主张、定价、获客、壁垒五个维度分析竞品，
 而不是比较功能列表。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（comp）或相关（pos）的历史记录：
+- 如果已有历史竞品分析 → 标注市场变化/竞品动向
+- 如果已有定位分析 → 作为竞品判断的参照系
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /comp 优先参考：竞品全景、市场数据
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次竞品分析相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 竞品识别
@@ -46,3 +84,54 @@
 - 只比功能不比商业模式——功能可以抄，商业模式抄不走
 - 低估「什么都不用」这个竞品——很多用户宁愿忍受也不换
 - 静态分析——不看竞品会怎么动
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/comp-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"comp","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"comp","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/gtm.md
+++ b/commands/gtm.md
@@ -4,6 +4,44 @@
 设计从 0 到 1 的冷启动策略和推广方案，核心问题是"第一批用户从哪来"
 和"怎么让他们留下来并帮你带人"。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（gtm）或相关（pos/comp）的历史记录：
+- 如果已有定位或竞品分析 → 作为推广输入
+- 如果已有历史推广方案 → 标注执行结果/调整点
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /gtm 优先参考：目标用户（画像+决策链）、行业背景
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次推广方案相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 冷启动策略
@@ -41,3 +79,54 @@
 - 没有种子用户就做大众推广
 - 渠道贪多嚼不烂（盯住一两个打透）
 - 把「砸钱」当策略而不是助攻
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/gtm-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"gtm","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"gtm","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/learn.md
+++ b/commands/learn.md
@@ -0,0 +1,205 @@
+# /learn - 知识库学习与检索
+
+## 命令定位
+摄入外部业务材料（报告、调研、数据、文档等），解析并汇总为结构化知识库，
+供所有 YxStack 指令在执行时自动加载参考。
+
+## 子命令
+
+| 子命令 | 用途 |
+|--------|------|
+| `/learn <路径>` | 摄入指定文件/目录，解析并更新知识库 |
+| `/learn update` | 增量更新，检测新增或修改的材料 |
+| `/learn show` | 查看当前知识库摘要（模块、材料数、最近更新） |
+| `/learn prune` | 修剪过期或矛盾的知识条目 |
+
+---
+
+## /learn <路径> — 摄入外部材料
+
+### Step 1: 扫描材料
+
+扫描目标路径，识别所有可处理文件：
+
+**支持格式**：
+- 文档：`.md`, `.txt`, `.pdf`, `.docx`
+- 表格：`.xlsx`, `.csv`
+- 演示：`.pptx`
+- 网页：`.html`, 直接输入 URL
+- 图片：`.png`, `.jpg`（OCR 文字提取）
+- 结构化数据：`.json`
+
+**跳过规则**：`.yxstack/`, `node_modules/`, `.git/`, `.DS_Store`
+**目录处理**：递归扫描，按修改时间排序
+
+### Step 2: 逐份解析
+
+对每个文件，使用 Read 工具读取内容，AI 模型提取结构化信息：
+
+**信息提取维度**：
+| 维度 | 提取内容 |
+|------|----------|
+| 行业数据 | 市场规模、增长率、政策环境、技术趋势（数字+来源页） |
+| 竞品信息 | 名称、定位、核心优势、主要劣势、价格带、目标用户 |
+| 用户信息 | 画像描述、痛点清单、采购/使用决策链、付费意愿 |
+| 约束条件 | 预算范围、时间节点、合规/监管要求、资源限制 |
+| 假设与观点 | 非事实性判断、预测性结论 → 务必标注为"假设"，归入待验证 |
+
+### Step 3: 知识汇总
+
+- **按模块归类**：行业背景 / 市场数据 / 竞品全景 / 目标用户 / 关键约束 / 待验证假设
+- **去重合并**：相同信息点合并为一条，标注多来源
+- **冲突处理**：矛盾信息点保留双方观点，归入「知识冲突」区域
+- **溯源标注**：每条关键信息标注来源材料 + 页码/段落
+
+### Step 4: 写入知识库
+
+将汇总结果写入 `.yxstack/learn/knowledge.md`：
+
+**新增模式**（knowledge.md 不存在）：创建新文件，写入全部模块
+**增量模式**（knowledge.md 已存在）：合并新材料信息，更新对应模块，追加材料溯源
+
+**knowledge.md 格式**：
+```markdown
+---
+title: "项目知识库"
+project: "{项目名称}"
+last_updated: "{YYYY-MM-DD}"
+materials_processed: {N}
+---
+
+# 项目知识库
+
+> 最近更新：{YYYY-MM-DD}
+> 已处理材料：{N} 份（详见 [材料溯源](#材料溯源)）
+
+## 行业背景
+- 关键事实1 [来源：材料A]
+- 关键事实2 [来源：材料B]
+
+## 市场数据
+| 指标 | 数值 | 来源 |
+|------|------|------|
+| 市场规模 | XXX | 材料A (p.12) |
+
+## 竞品全景
+| 竞品 | 定位 | 核心优势 | 主要劣势 | 价格带 | 来源 |
+|------|------|----------|----------|--------|------|
+
+## 目标用户
+- 核心用户画像：[来源]
+- 痛点清单（按严重程度）：
+  1. 痛点1 [来源]
+  2. 痛点2 [来源]
+- 付费意愿与能力：[来源]
+
+## 关键约束
+- 预算约束：
+- 时间约束：
+- 合规/监管约束：
+- 资源约束：
+
+## 待验证假设
+| 假设 | 验证路径 | 来源 |
+|------|----------|------|
+| XXX  | 如何验证 | 材料C |
+
+## 知识冲突
+| 主题 | 观点A | 来源A | 观点B | 来源B |
+|------|-------|-------|-------|-------|
+
+## 材料溯源
+| 材料 | 类型 | 处理时间 | 关键信息贡献 |
+|------|------|----------|-------------|
+```
+
+### Step 5: 更新元数据
+
+更新 `.yxstack/learn/_learn_meta.json`：
+```json
+{
+  "project": "{项目名称}",
+  "last_updated": "{ISO时间戳}",
+  "materials_processed": N,
+  "materials": [
+    {
+      "name": "材料名称",
+      "path": "原始路径",
+      "type": "pdf",
+      "processed_at": "ISO时间戳",
+      "sha256": "可选：文件哈希"
+    }
+  ]
+}
+```
+
+---
+
+## /learn update — 增量更新
+
+重新扫描已记录的材料目录，检测：
+- 新增文件 → 解析并追加到 knowledge.md
+- 修改过的文件 → 标记对应模块为「待更新」，重新解析
+- 删除的文件 → 保留历史知识，标记来源材料已不可用
+
+---
+
+## /learn show — 查看摘要
+
+读取 `.yxstack/learn/knowledge.md`，简洁展示：
+- 知识库覆盖的模块列表
+- 已处理材料数量
+- 最近更新时间
+- 待验证假设数量
+- 知识冲突数量
+
+---
+
+## /learn prune — 修剪知识库
+
+对标 gstack 的 `/learn prune` 机制：
+
+1. **过期检测**：检查每条信息的来源材料是否仍可访问
+2. **矛盾检测**：检查同一主题下是否存在相互矛盾的结论
+3. **置信度评估**：标注每条知识的可靠性（从来源材料质量推断）
+4. **用户确认**：对标记条目逐条询问：
+   - 删除（知识已过时）
+   - 保留（仍有效）
+   - 降级（标注为「待验证」）
+5. 修剪后更新 knowledge.md
+
+判断标准：「下次执行分析时，这条知识还有参考价值吗？」
+
+---
+
+## 存档规则
+
+/learn 本身不产生报告文件（不同于其他 YxStack 指令），而是直接维护 `.yxstack/learn/knowledge.md`。
+
+执行 `/learn` 后，追加事件日志：
+```json
+{"skill":"learn","event":"completed","ts":"当前时间","summary":"摄入 N 份材料，知识库已更新","decision":"新增/更新模块列表"}
+```
+
+---
+
+## 与其他指令的关系
+
+| 指令 | 如何引用知识库 |
+|------|---------------|
+| /pfit | 参考目标用户（痛点清单）、待验证假设 |
+| /pos | 参考竞品全景、行业背景、市场数据 |
+| /uj | 参考目标用户（画像+决策链）、痛点清单 |
+| /prd | 参考全部模块 |
+| /money | 参考市场数据、竞品全景（价格带）、关键约束（预算） |
+| /gtm | 参考目标用户（画像+决策链）、行业背景 |
+| /metric | 参考市场数据（行业基准）、关键约束 |
+| /comp | 参考竞品全景、市场数据 |
+
+---
+
+## 常见误区
+- 把个人观点当事实写入知识库（应标注为假设）
+- 材料之间的信息不核实矛盾直接合并（应标注冲突）
+- 知识库只建不维护（应定期 prune）
+- 把单个来源的结论当作确定事实（应标注置信度）
--- a/commands/metric.md
+++ b/commands/metric.md
@@ -4,6 +4,44 @@
 搭建能真正指导决策的业务指标体系，而不是堆砌指标看板。
 含复盘框架，确保从数据中找到可行动的点。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（metric）或相关（prd）的历史记录：
+- 如果已有 PRD → 基于 PRD 目标定指标
+- 如果已有历史指标体系 → 对比历史数据趋势
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /metric 优先参考：市场数据（行业基准）、关键约束
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次指标分析相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 北极星指标
@@ -45,3 +83,54 @@
 - 指标太多等于没指标
 - 只看总量不看分层（新老用户、付费/免费）
 - 把观测指标当行动指标（DAU 降了不会告诉你怎么修）
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/metric-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"metric","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"metric","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/money.md
+++ b/commands/money.md
@@ -3,6 +3,44 @@
 ## 命令定位
 设计可持续的商业模式和定价体系，打通付费转化链路。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（money）或相关（prd/comp）的历史记录：
+- 如果已有 PRD 或竞品分析 → 作为定价输入
+- 如果已有历史定价方案 → 标注迭代点/市场变化
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /money 优先参考：市场数据、竞品全景（价格带）、关键约束（预算）
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次商业模式分析相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 收入模型
@@ -41,3 +79,54 @@
 - 定价跟着成本走而不是跟着价值走
 - 免费层太大导致没人付费
 - 只看注册数不看付费转化率
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/money-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"money","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"money","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/pfit.md
+++ b/commands/pfit.md
@@ -4,6 +4,44 @@
 在投入产品资源之前，验证用户所述「痛点」是否真实存在、
 是否足够痛、是否值得解决。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（pfit）的历史记录：
+- 如果有同类问题的分析结论 → 标注一致性/矛盾/更新点
+- 如果历史结论是 No-Go → 追问"现在的条件跟当时有什么变化？"
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /pfit 优先参考：目标用户（痛点清单）、待验证假设
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次痛点验证相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 痛点来源验证
@@ -39,3 +77,55 @@
 - 把自己的痛点当成用户的痛点
 - 把「不足」当「痛点」（功能不够炫 vs 核心场景受阻）
 - 因一两个用户的强烈反馈而过度反应
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/pfit-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+**文件名示例**：`pfit-2026-05-03-药企科普合规路径.md`
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"pfit","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"pfit","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/pos.md
+++ b/commands/pos.md
@@ -3,6 +3,50 @@
 ## 命令定位
 明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（pos）的历史记录：
+- 如果有同类产品的定位分析 → 标注与历史定位的一致性/差异点
+- 如果历史定位已被市场验证失败 → 追问"现在的基础条件有什么变化？"
+- 如果没有历史记录 → 跳过，正常执行
+
+### 前置指令摘要
+读取 `.yxstack/` 中最近 pfit（痛点验证）记录，提取：
+- 已验证的痛点结论（一句话）
+- 未解决的待处理项
+- 本次定位需基于已验证痛点，而非从零重建假设
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /pos 优先参考：竞品全景、行业背景、市场数据
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次定位分析相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 价值主张提炼
@@ -34,3 +78,55 @@
 - 拿功能当定位（"我们更快"不如"你能多睡一小时"）
 - 面面俱到等于没有定位
 - 对标大厂但不具备大厂的资源禀赋
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/pos-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+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）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"pos","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
+
--- a/commands/prd.md
+++ b/commands/prd.md
@@ -4,6 +4,44 @@
 从业务视角写一份可执行的 PRD，聚焦业务逻辑流、角色分工、
 数据流转，明确 MVP 的精确边界和功能优先级。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（prd）或相关（pfit/pos）的历史记录：
+- 如果已有痛点验证（pfit）或定位分析（pos）→ 作为 PRD 输入，不重复追问
+- 如果已有同类 PRD → 标注与历史版的差异/迭代点
+- 如果没有历史记录 → 跳过，正常执行
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /prd 优先参考：全部模块
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次 PRD 相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 业务目标
@@ -43,3 +81,54 @@
 - PRD 写成功能说明书而不是业务文档
 - MVP 边界无限扩大（加了太多"万一需要"的场景）
 - 没有明确「不做哪些」——真正重要的决策
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/prd-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"prd","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"prd","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/commands/uj.md
+++ b/commands/uj.md
@@ -4,6 +4,50 @@
 还原用户从「第一次听说」到「成为忠实用户」到「可能流失」的完整
 行为路径，标注每个节点的情绪曲线、决策障碍和流失原因。

+## 第 0 步：加载项目状态
+
+执行本指令前，先读取项目根目录下的 `.yxstack/_state.md`（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径）：
+- 了解项目当前所处的 YxStack 阶段（exploration/validation/positioning/pricing/growth）
+- 确认已有的关键假设和决策
+- 检查是否有与本次指令相关的待处理项
+- 如果 _state.md 不存在，说明这是项目首次使用 YxStack
+
+然后按原有规则检查历史记录：
+
+执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md
+自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（uj）的历史记录：
+- 如果有同类用户旅程分析 → 标注与历史结论的差异/更新点
+- 如果历史已有流失节点结论 → 追问"当前数据跟当时比有什么变化？"
+- 如果没有历史记录 → 跳过，正常执行
+
+### 前置指令摘要
+读取 `.yxstack/` 中最近 pfit（痛点验证）+ pos（产品定位）记录，提取：
+- 已验证的痛点结论（来自 pfit）
+- 已确认的产品定位（来自 pos）
+- 旅程分析应基于已知痛点和定位，而非重新猜测用户卡点
+
+### Confusion Protocol（假设暴露）
+在执行本指令时，遇到以下情况停止推理，转为追问用户：
+- 对用户业务场景的关键事实在猜测而非确认
+- 对市场/用户行为的判断缺少定量或定性证据
+- 在多个不相容假设之间跳转（信号：假设 > 3 个未验证）
+
+激活时机：上述任一条触发时，列出已知/未知，追问缺失信息，不继续产出。
+
+### 加载知识库
+读取 `.yxstack/learn/knowledge.md`（如果存在）：
+- /uj 优先参考：目标用户（画像+决策链）、痛点清单
+- 如果有相关数据，直接引用而非重新追问用户
+- 如果知识库信息与本次分析结论矛盾，标记为「待验证」并追问
+- 如果 knowledge.md 不存在，跳过
+
+### 加载近期学习
+搜索 `.yxstack/_timeline.jsonl` 中最近 10 条高置信度（≥7）的学习记录（type=insight/decision/pitfall）：
+- 若有与本次旅程分析相关的洞察 → 引用而非重新推理
+- 若发现与历史洞察矛盾的结论 → 标记为「待验证」
+- 若无相关记录 → 跳过
+
 ## 核心追问清单

 ### 1. 旅程阶段划分
@@ -35,3 +79,54 @@
 - 用自己的行为推演用户（你是超级用户，他不是）
 - 只看「用的人」不看「没用的人」（沉默证据偏差）
 - 没有区分不同用户类型的旅程差异
+
+## 存档规则
+
+执行完毕生成报告后，按以下规范存档：
+
+**默认路径**：`{项目根目录}/.yxstack/uj-{日期}-{一句话摘要}.md`
+（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径）
+
+**格式**：YAML frontmatter + 报告正文
+```yaml
+---
+title: "{一句话标题}"
+author: "{执行者}"
+date: "{YYYY-MM-DD}"
+tags: ["关键词1", "关键词2"]
+status: draft  # draft → validated → outdated
+---
+```
+
+## 更新项目状态
+
+### 追加事件日志
+向 `.yxstack/_timeline.jsonl` 追加一行：
+```json
+{"skill":"uj","event":"completed","ts":"当前时间","phase":"当前阶段","summary":"本次产出核心结论","assumption":"本次新增假设（有则填，无则留空）","decision":"本次关键决策（有则填，无则留空）"}
+```
+
+### 更新状态快照
+更新 `.yxstack/_state.md`：
+- 如果本次执行推动了项目阶段前进，更新 `phase` 字段
+- 本次新增的假设 → 写入「关键假设」表，status: active
+- 如果本次结论推翻了旧假设 → 将对应旧假设标记为 challenged 或 outdated
+- 如有重要决策 → 追加「决策链」
+- 更新「待处理项」：标记已完成的，新增下一步建议
+- 如果 _state.md 不存在，按模板创建（参考 templates/state_template.md）
+- 每个 active 假设必须附带验证标准（一句话：用什么证据可证实/证伪）
+- 同时 active 假设不超过 5 条，达到上限时必须先标记一条旧假设为 outdated 才能新增
+
+### 自动发现（Operational Self-Improvement）
+本指令执行完成后，回顾本次产出的核心结论：
+- 是否有对后续指令有参考价值的洞察？→ 追加 `_timeline.jsonl`，type: insight
+- 是否有可复用的决策模式？→ 追加 `_timeline.jsonl`，type: decision
+- 是否发现了需要避免的判断陷阱？→ 追加 `_timeline.jsonl`，type: pitfall
+
+判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
+不记录：显而易见的事实、一次性结论、与已有知识完全重复的内容。
+
+追加格式：
+```json
+{"skill":"uj","event":"completed","type":"insight|decision|pitfall","key":"kebab-case-键","insight":"一句话洞察","confidence":N,"ts":"当前时间"}
+```
--- a/install.sh
+++ b/install.sh
@@ -0,0 +1,124 @@
+#!/bin/bash
+# ============================================================
+# YxStack 一键安装脚本
+# 用法：curl -sSL {raw_url} | bash
+# 或者：bash install.sh
+# ============================================================
+set -e
+
+REPO_URL="http://82.157.208.197:3000/qiukai/yxstack-skill.git"
+YXSTACK_DIR="$HOME/.codebuddy/yxstack"
+CODEBUDDY_MD="$HOME/.codebuddy/CODEBUDDY.md"
+
+YxSTACK_CONFIG='
+## YxStack 工作流
+采用 **圆心商业化工作流（YxStack）** 作为全局默认规范。
+
+### 核心约束
+- 专注业务策略、产品规划、商业模式、增长运营
+- 不输出研发实现、代码、技术架构、UI 设计
+
+### 内置指令
+| 指令 | 用途 |
+|------|------|
+| /pfit | 痛点真伪验证 |
+| /pos | 产品定位与差异化 |
+| /uj | 用户旅程与流失分析 |
+| /prd | 业务型 PRD 与 MVP 定义 |
+| /money | 商业模式与定价体系 |
+| /gtm | 冷启动与推广方案 |
+| /metric | 业务指标与复盘 |
+| /comp | 竞品商业分析 |
+| /learn | 知识库学习与检索 |
+
+使用指令时，需读取 `~/.codebuddy/yxstack/commands/{command}.md`
+获取完整执行模板，并按模板中的 Checklist 执行。
+
+完整定义见 `~/.codebuddy/yxstack/README.md`。
+
+### 自动升级
+每次会话开始时（或用户第一次使用 YxStack 指令前），检查版本更新：
+
+```bash
+cd ~/.codebuddy/yxstack && \
+  git fetch origin 2>/dev/null; \
+  REMOTE=$(git ls-remote --tags origin 2>/dev/null | awk -F/ \047/v[0-9]/ {print $NF}\047 | sort -V | tail -1); \
+  LOCAL=$(cat VERSION 2>/dev/null); \
+  if [ -n "$REMOTE" ] && [ "$REMOTE" != "$LOCAL" ]; then \
+    echo "YxStack 有新版本：$LOCAL → $REMOTE，建议升级"; \
+  fi
+```
+
+如果检测到新版本，提示用户：「YxStack 有新版本 vX.Y.Z，是否升级？」用户确认后执行 \`bash ~/.codebuddy/yxstack/install.sh\`。
+
+### 会话状态恢复
+
+每次会话开始时，自动执行以下流程：
+1. 查找当前项目是否存在 `.yxstack/_state.md`
+2. 如果存在，读取并给出「上次到这里了：当前在 {phase} 阶段，上次执行了 {last_command}」的 2 句欢迎摘要
+3. 如果「待处理项」中有明确的下一步指令，主动建议执行
+4. 如果 `_state.md` 不存在，跳过，正常开始会话
+
+### 项目边界规则
+
+YxStack 项目根 = 当前工作目录（CWD）。所有指令的 `.yxstack/` 均指向 CWD 下的路径。
+无需搜寻父目录或上级项目。不跨项目串读历史记录。
+
+项目状态文件 `.yxstack/_state.md` 和事件日志 `_timeline.jsonl` 由 YxStack 指令自动维护，
+参考模板见 `~/.codebuddy/yxstack/templates/state_template.md`。
+
+开源仓库：http://82.157.208.197:3000/qiukai/yxstack-skill
+维护方：筑基阁（开阳星）
+'
+
+echo ""
+echo "  ★ 圆心商业化工作流（YxStack）安装中..."
+echo ""
+
+# 1. 克隆仓库
+if [ -d "$YXSTACK_DIR" ]; then
+    echo "  [1/2] 更新 YxStack 模板..."
+    cd "$YXSTACK_DIR"
+    git pull --ff-only 2>/dev/null || {
+        echo "  ⚠ 更新失败，重新克隆..."
+        cd "$HOME"
+        rm -rf "$YXSTACK_DIR"
+        git clone "$REPO_URL" "$YXSTACK_DIR"
+    }
+else
+    echo "  [1/2] 下载 YxStack 模板..."
+    mkdir -p "$HOME/.codebuddy"
+    git clone "$REPO_URL" "$YXSTACK_DIR"
+fi
+
+# 2. 配置 CODEBUDDY.md
+echo "  [2/2] 配置全局工作流..."
+
+if [ ! -f "$CODEBUDDY_MD" ]; then
+    # 全新用户，创建文件
+    echo "# 全局配置" > "$CODEBUDDY_MD"
+    echo "$YxSTACK_CONFIG" >> "$CODEBUDDY_MD"
+    echo "  ✓ 已创建 CODEBUDDY.md 并写入 YxStack 配置"
+elif grep -q "YxStack\|yxstack\|圆心商业化工作流" "$CODEBUDDY_MD" 2>/dev/null; then
+    echo "  ✓ CODEBUDDY.md 已包含 YxStack 配置，跳过"
+else
+    # 已有文件但没有 YxStack，追加
+    echo "" >> "$CODEBUDDY_MD"
+    echo "$YxSTACK_CONFIG" >> "$CODEBUDDY_MD"
+    echo "  ✓ 已在现有 CODEBUDDY.md 末尾追加 YxStack 配置"
+fi
+
+echo ""
+echo "  ★ 安装完成！版本：$(cat VERSION 2>/dev/null || echo '未知')"
+echo ""
+echo "  现在你可以使用以下指令："
+echo "    /pfit   — 验证痛点真伪"
+echo "    /pos    — 产品定位与差异化"
+echo "    /uj     — 用户旅程分析"
+echo "    /prd    — 业务型 PRD"
+echo "    /money  — 商业模式与定价"
+echo "    /gtm    — 冷启动方案"
+echo "    /metric — 业务指标体系"
+echo "    /comp   — 竞品商业分析"
+echo "    /learn  — 知识库学习与检索"
+echo ""
--- a/templates/state_template.md
+++ b/templates/state_template.md
@@ -0,0 +1,117 @@
+# YxStack 项目状态模板
+
+## _timeline.jsonl
+
+追加格式，每行一条指令执行记录：
+
+```json
+{"skill":"pfit","event":"completed","ts":"2026-05-03T10:02:22+08:00","phase":"exploration","summary":"XX痛点验证通过，Go","assumption":"用户对XX的需求是刚需","decision":""}
+```
+
+字段说明：
+
+| 字段 | 必需 | 说明 |
+|------|------|------|
+| `skill` | 是 | 指令名: pfit/pos/uj/prd/money/gtm/metric/comp/learn |
+| `event` | 是 | `completed` |
+| `ts` | 是 | ISO 8601 时间戳，带时区 |
+| `phase` | 否 | 当前阶段: exploration/validation/positioning/pricing/growth |
+| `summary` | 否 | 本次产出的核心结论（一句话） |
+| `assumption` | 否 | 本次新增的关键假设 |
+| `decision` | 否 | 本次做出的关键决策 |
+| `conflict` | 否 | 本次发现的冲突（如有），格式：`{冲突假设}:{冲突描述}` |
+| `type` | 否 | 学习记录类型：`insight` / `decision` / `pattern` / `pitfall`（自动发现时写入） |
+| `confidence` | 否 | 置信度 1-10，自动发现时赋予，prune 时可调整 |
+| `key` | 否 | kebab-case 短键，用于去重和检索（自动发现时必填） |
+
+特点：
+- 只追加不修改 — 不会因写入中断损坏历史
+- 可重建 — _state.md 丢失时从 timeline 重新推导
+- 零依赖 — `echo '{...}' >> file` 即可
+
+## _state.md
+
+从 timeline 推导的当前项目状态快照。首次使用时创建，每次指令执行完更新。
+
+```yaml
+---
+project: "{项目名称}"
+phase: "{当前阶段}"
+last_session: "2026-05-03"
+last_command: "pfit"
+---
+
+## 当前阶段
+{一句话描述当前在 YxStack 流程的哪个位置}
+
+## 关键假设
+| 假设 | 状态 | 验证标准 | 来源指令 | 提出时间 |
+|------|------|----------|----------|----------|
+| {假设内容} | active/challenged/outdated | {可证伪的一句话} | /xxx | YYYY-MM-DD |
+
+假设状态取值规范：
+- `active` — 当前认可，作为后续决策的依据
+- `challenged` — 发现矛盾或新证据，待重新验证
+- `outdated` — 已被新结论推翻或环境已变化
+- 同时 active 假设不超过 5 条，达到上限时先标记旧假设为 outdated 才能新增
+
+## 决策链
+1. YYYY-MM-DD /xxx: {决策内容} — {理由}
+
+## 待处理项
+- [ ] {事项}
+```
+
+### 更新规则
+
+指令执行完后，更新 _state.md：
+
+| 字段 | 何时更新 |
+|------|----------|
+| `phase` | 本次指令推动了阶段前进时更新 |
+| `last_session` | 每次更新为当天 |
+| `last_command` | 每次更新为本次指令 |
+| `关键假设` | 新增假设（active）、推翻旧假设（challenged/outdated） |
+| `决策链` | 有重要决策时追加 |
+| `待处理项` | 标记完成 + 新增下一步 |
+
+### 阶段流转建议
+
+```
+exploration → validation → positioning → pricing → growth
+   (pfit)       (uj)          (pos)     (money)    (gtm/metric)
+                                   ↘    (comp)
+```
+
+不强制线性，但提供参考。阶段变化是状态更新的核心信号。
+
+## learn/knowledge.md — 项目知识库
+
+由 `/learn` 指令维护的外部知识摄入产物，存储于 `.yxstack/learn/knowledge.md`。
+
+**格式**：YAML frontmatter + Markdown 模块
+```yaml
+---
+title: "项目知识库"
+project: "{项目名称}"
+last_updated: "2026-05-03"
+materials_processed: 5
+---
+```
+
+**模块结构**：
+- 行业背景 — 市场规模、政策环境、技术趋势
+- 市场数据 — 用户规模、增长率、行业基准
+- 竞品全景 — 竞品定位/优势/劣势/价格带
+- 目标用户 — 画像、痛点清单、决策链、付费意愿
+- 关键约束 — 预算、时间、合规、资源
+- 待验证假设 — 非事实性判断，标注验证路径和来源
+- 知识冲突 — 相同主题的矛盾观点，分别溯源
+- 材料溯源 — 已处理材料清单 + 贡献
+
+**更新方式**：
+- `/learn <路径>` — 手动摄入外部材料
+- `/learn update` — 增量检测新增/修改的材料
+- `/learn prune` — 修剪过期/矛盾的知识条目
+
+**自动发现**：8 条命令执行完毕后，自动将高价值洞察写入 `_timeline.jsonl`（type: insight/decision/pitfall）。
Author	SHA1	Message	Date
开阳星	75152c36c2	feat: v0.3.0 — /learn 知识库 + 自动发现对照 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 更新	2026-05-03 05:08:39 +08:00
开阳星	d8c21dd38a	docs: ROADMAP v0.2.1 checklist 标记完成，v0.3.0 设为当前	2026-05-03 04:21:45 +08:00
开阳星	20d322be2f	chore: v0.2.1 — Confusion Protocol + 假设约束 + 项目边界声明 + 前置摘要恢复借鉴 gstack 设计模式： - 8 条命令统一引入 Confusion Protocol（关键事实缺证据停止推理） - 假设验证路径 + 假设上限（≤5 条 active） - CWD 显式项目边界声明 - pos/uj 前置指令摘要（对标 gstack /context-restore） - ROADMAP 同步 + state_template 增强 - CHANGELOG v0.2.1	2026-05-03 04:19:55 +08:00
开阳星	a24b1d4d70	chore: 更新版本号 v0.1.2 → v0.2.0	2026-05-03 03:27:47 +08:00
开阳星	ce844cdf51	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 做当前快照	2026-05-03 03:26:46 +08:00
开阳星	3bfe1a7cbe	chore: VERSION 更正为 v0.1.2	2026-05-03 01:49:35 +08:00
开阳星	3abd9b4e52	docs: v0.1.2 CHANGELOG 和 ROADMAP	2026-05-03 01:49:08 +08:00
开阳星	427e10214b	feat: 自动升级机制——Agent会话启动时检查新版本	2026-05-03 01:48:40 +08:00
开阳星	0cad620951	docs: 更新 v0.1.1 的 ROADMAP 和 CHANGELOG	2026-05-03 01:44:31 +08:00
开阳星	67d65b18bc	feat: 一行安装脚本，降低新人上手门槛	2026-05-03 01:43:35 +08:00
开阳星	eec437fd67	feat: v0.1.0 知识沉淀机制新增： - 每条指令增加「第 0 步：回溯历史」 - 每条指令增加「存档规则」 - 默认存档路径：{项目根目录}/.yxstack/ - 跨项目隔离机制变更： - 所有路径改为项目根目录相对路径，不绑定特定项目结构 - README 新增知识沉淀机制说明 - ROADMAP 加入知识沉淀路线 - CHANGELOG 更新 v0.1.0 记录	2026-05-03 01:19:32 +08:00