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 更新
This commit is contained in:
开阳星
2026-05-03 05:08:39 +08:00
parent d8c21dd38a
commit 75152c36c2
14 changed files with 508 additions and 6 deletions

View File

@@ -12,7 +12,7 @@
| 字段 | 必需 | 说明 |
|------|------|------|
| `skill` | 是 | 指令名: pfit/pos/uj/prd/money/gtm/metric/comp |
| `skill` | 是 | 指令名: pfit/pos/uj/prd/money/gtm/metric/comp/learn |
| `event` | 是 | `completed` |
| `ts` | 是 | ISO 8601 时间戳,带时区 |
| `phase` | 否 | 当前阶段: exploration/validation/positioning/pricing/growth |
@@ -20,6 +20,9 @@
| `assumption` | 否 | 本次新增的关键假设 |
| `decision` | 否 | 本次做出的关键决策 |
| `conflict` | 否 | 本次发现的冲突(如有),格式:`{冲突假设}:{冲突描述}` |
| `type` | 否 | 学习记录类型:`insight` / `decision` / `pattern` / `pitfall`(自动发现时写入) |
| `confidence` | 否 | 置信度 1-10自动发现时赋予prune 时可调整 |
| `key` | 否 | kebab-case 短键,用于去重和检索(自动发现时必填) |
特点:
- 只追加不修改 — 不会因写入中断损坏历史
@@ -81,3 +84,34 @@ exploration → validation → positioning → pricing → growth
```
不强制线性,但提供参考。阶段变化是状态更新的核心信号。
## 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