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 更新
118 lines
4.0 KiB
Markdown
118 lines
4.0 KiB
Markdown
# 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）。
|