Files

开阳星 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

4.0 KiB

Raw Permalink Blame History

YxStack 项目状态模板

_timeline.jsonl

追加格式，每行一条指令执行记录：

{"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 推导的当前项目状态快照。首次使用时创建，每次指令执行完更新。

---
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 模块

---
title: "项目知识库"
project: "{项目名称}"
last_updated: "2026-05-03"
materials_processed: 5
---

模块结构：

行业背景 — 市场规模、政策环境、技术趋势
市场数据 — 用户规模、增长率、行业基准
竞品全景 — 竞品定位/优势/劣势/价格带
目标用户 — 画像、痛点清单、决策链、付费意愿
关键约束 — 预算、时间、合规、资源
待验证假设 — 非事实性判断，标注验证路径和来源
知识冲突 — 相同主题的矛盾观点，分别溯源
材料溯源 — 已处理材料清单 + 贡献

更新方式：

/learn <路径> — 手动摄入外部材料
/learn update — 增量检测新增/修改的材料
/learn prune — 修剪过期/矛盾的知识条目

自动发现：8 条命令执行完毕后，自动将高价值洞察写入 _timeline.jsonl（type: insight/decision/pitfall）。

4.0 KiB Raw Permalink Blame History Unescape Escape