9 Commits

Author SHA1 Message Date
开阳星
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
14 changed files with 886 additions and 17 deletions

View File

@@ -1,5 +1,75 @@
# 圆心商业化工作流YxStack变更记录 # 圆心商业化工作流YxStack变更记录
## 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` 增加验证标准列 + 假设状态取值规范
### 设计参考
- 对比 gstackYC 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) ## v0.0.1 (2026-05-03)
### 新增 ### 新增

View File

@@ -33,20 +33,49 @@ YxStack 是一套**业务产品工作流规范**,用于指导产品经理和
每个指令的详细执行模板见 `commands/` 目录。 每个指令的详细执行模板见 `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 ```bash
# 工作流规范 git clone http://82.157.208.197:3000/qiukai/yxstack-skill.git ~/.codebuddy/yxstack/ && bash ~/.codebuddy/yxstack/install.sh
采用 **圆心商业化工作流YxStack** 作为全局默认规范。
使用指令时,需读取 `~/.codebuddy/yxstack/commands/{command}.md`
获取完整执行模板,并按模板中的 Checklist 执行。
完整定义见 `~/.codebuddy/yxstack/README.md`
``` ```
脚本会自动:
1. 下载 YxStack 模板到 `~/.codebuddy/yxstack/`
2.`~/.codebuddy/CODEBUDDY.md` 中添加 YxStack 配置(已配过则跳过)
装完直接在你的 CodeBuddy Code 里输入 `/pfit``/pos` 等指令即可使用。
**升级**:安装和升级是同一条命令,再跑一次即可:
```bash
bash ~/.codebuddy/yxstack/install.sh
```
## 自动升级
安装后Agent 每次会话启动时自动检查远端版本号。如果发现新版本,会主动提醒你升级,确认后自动执行。
## 项目负责人 ## 项目负责人
- 维护:筑基阁(开阳星) - 维护:筑基阁(开阳星)

View File

@@ -6,36 +6,90 @@
- [x] 8 条命令执行模板Checklist + 输出结构 + 常见误区) - [x] 8 条命令执行模板Checklist + 输出结构 + 常见误区)
- [x] 全局 CODEBUDDY.md 集成机制 - [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 — 漏洞修补 ← 当前
借鉴 gstackYC CEO Garry Tan 开源的 AI 工程团队工作流)的设计模式,补齐遗留项。
- [ ] **Confusion Protocol** — 8 条命令统一引入假设暴露机制:关键事实缺证据时停止推理,转为追问
- [ ] **假设验证路径** — 每个 active 假设必须附带可证伪的验证标准
- [ ] **假设上限** — 同时 active 假设 ≤ 5 条,超过必须先标记旧假设为 outdated
- [ ] **项目边界显式声明** — CWD 即 YxStack 项目根,不搜索父目录(对标 gstack CWD + /freeze 模式)
- [ ] **前置摘要恢复** — pos.md 回溯 pfit 结论uj.md 回溯 pfit + pos 结论(对标 gstack /context-restore 的 Summary + Remaining 结构)
- [ ] ROADMAP 同步 — v0.2.0 标记完成v0.1.0 遗留项下移
## v0.3.0 — 指令深度增强(原 v0.2.0
- [ ] 为每条命令增加典型场景案例库 - [ ] 为每条命令增加典型场景案例库
- [ ] 细化各阶段追问权重与优先级 - [ ] 细化各阶段追问权重与优先级
- [ ] 增加"未完待续"处理策略(信息不足时怎么收口) - [ ] 增加"未完待续"处理策略(信息不足时怎么收口)
## v0.2.0 — 命令组合模式 ## v0.4.0 — 命令组合模式(原 v0.3.0
- [ ] `/prd + /pfit` = 完整产品评审流程 - [ ] `/prd + /pfit` = 完整产品评审流程
- [ ] `/pos + /comp` = 市场定位全景分析 - [ ] `/pos + /comp` = 市场定位全景分析
- [ ] `/uj + /metric` = 用户体验指标体系 - [ ] `/uj + /metric` = 用户体验指标体系
- [ ] 组合命令的输出融合规范 - [ ] 组合命令的输出融合规范
## v0.3.0 — 场景自动识别 ## v0.5.0 — 场景自动识别(原 v0.4.0
- [ ] 模型无需用户显式使用 `/xxx`,自动识别当前场景 - [ ] 模型无需用户显式使用 `/xxx`,自动识别当前场景
- [ ] 自动匹配最相关的 1-2 条指令 - [ ] 自动匹配最相关的 1-2 条指令
- [ ] 渐进式引导——先判断在哪个阶段,再切入对应清单 - [ ] 渐进式引导——先判断在哪个阶段,再切入对应清单
## v0.4.0 — 扩展生态 ## v0.6.0 — 扩展生态(原 v0.5.0
- [ ] 支持行业定制模板SaaS、电商、医疗、教育等 - [ ] 支持行业定制模板SaaS、电商、医疗、教育等
- [ ] 集成到 Hookify 体系——通过 prompt 钩子自动匹配场景 - [ ] 集成到 Hookify 体系——通过 prompt 钩子自动匹配场景
- [ ] 社区贡献机制——开放命令模板 Pull Request 流程 - [ ] 社区贡献机制——开放命令模板 Pull Request 流程
## v1.0.0 — 产品级可靠 ## v1.0.0 — 完整评测体系
- [ ] 完整评测体系(每个指令的一致性、准确性、覆盖度) - [ ] 一致性评测——同一场景多轮输出是否自洽
- [ ] 使用数据追踪与持续优化 - [ ] 准确性评测——标准场景下输出是否命中关键点
- [ ] 多轮对话状态保持与上下文管理 - [ ] 覆盖度评测——每条命令的 Checklist 是否覆盖边界情况
- [ ] 评测集构建——10-20 个标准场景 + 期望输出标准
- [ ] 发版前自动评测流程
--- ---

1
VERSION Normal file
View File

@@ -0,0 +1 @@
v0.2.1

View File

@@ -4,6 +4,31 @@
从商业模式、价值主张、定价、获客、壁垒五个维度分析竞品, 从商业模式、价值主张、定价、获客、壁垒五个维度分析竞品,
而不是比较功能列表。 而不是比较功能列表。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 竞品识别 ### 1. 竞品识别
@@ -46,3 +71,40 @@
- 只比功能不比商业模式——功能可以抄,商业模式抄不走 - 只比功能不比商业模式——功能可以抄,商业模式抄不走
- 低估「什么都不用」这个竞品——很多用户宁愿忍受也不换 - 低估「什么都不用」这个竞品——很多用户宁愿忍受也不换
- 静态分析——不看竞品会怎么动 - 静态分析——不看竞品会怎么动
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.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 才能新增

View File

@@ -4,6 +4,31 @@
设计从 0 到 1 的冷启动策略和推广方案,核心问题是"第一批用户从哪来" 设计从 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 冷启动策略 ### 1. 冷启动策略
@@ -41,3 +66,40 @@
- 没有种子用户就做大众推广 - 没有种子用户就做大众推广
- 渠道贪多嚼不烂(盯住一两个打透) - 渠道贪多嚼不烂(盯住一两个打透)
- 把「砸钱」当策略而不是助攻 - 把「砸钱」当策略而不是助攻
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.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 才能新增

View File

@@ -4,6 +4,31 @@
搭建能真正指导决策的业务指标体系,而不是堆砌指标看板。 搭建能真正指导决策的业务指标体系,而不是堆砌指标看板。
含复盘框架,确保从数据中找到可行动的点。 含复盘框架,确保从数据中找到可行动的点。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 北极星指标 ### 1. 北极星指标
@@ -45,3 +70,40 @@
- 指标太多等于没指标 - 指标太多等于没指标
- 只看总量不看分层(新老用户、付费/免费) - 只看总量不看分层(新老用户、付费/免费)
- 把观测指标当行动指标DAU 降了不会告诉你怎么修) - 把观测指标当行动指标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 才能新增

View File

@@ -3,6 +3,31 @@
## 命令定位 ## 命令定位
设计可持续的商业模式和定价体系,打通付费转化链路。 设计可持续的商业模式和定价体系,打通付费转化链路。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 收入模型 ### 1. 收入模型
@@ -41,3 +66,40 @@
- 定价跟着成本走而不是跟着价值走 - 定价跟着成本走而不是跟着价值走
- 免费层太大导致没人付费 - 免费层太大导致没人付费
- 只看注册数不看付费转化率 - 只看注册数不看付费转化率
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.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 才能新增

View File

@@ -4,6 +4,31 @@
在投入产品资源之前,验证用户所述「痛点」是否真实存在、 在投入产品资源之前,验证用户所述「痛点」是否真实存在、
是否足够痛、是否值得解决。 是否足够痛、是否值得解决。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 痛点来源验证 ### 1. 痛点来源验证
@@ -39,3 +64,41 @@
- 把自己的痛点当成用户的痛点 - 把自己的痛点当成用户的痛点
- 把「不足」当「痛点」(功能不够炫 vs 核心场景受阻) - 把「不足」当「痛点」(功能不够炫 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 才能新增

View File

@@ -3,6 +3,37 @@
## 命令定位 ## 命令定位
明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。 明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 价值主张提炼 ### 1. 价值主张提炼
@@ -34,3 +65,41 @@
- 拿功能当定位("我们更快"不如"你能多睡一小时" - 拿功能当定位("我们更快"不如"你能多睡一小时"
- 面面俱到等于没有定位 - 面面俱到等于没有定位
- 对标大厂但不具备大厂的资源禀赋 - 对标大厂但不具备大厂的资源禀赋
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.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 才能新增

View File

@@ -4,6 +4,31 @@
从业务视角写一份可执行的 PRD聚焦业务逻辑流、角色分工、 从业务视角写一份可执行的 PRD聚焦业务逻辑流、角色分工、
数据流转,明确 MVP 的精确边界和功能优先级。 数据流转,明确 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 业务目标 ### 1. 业务目标
@@ -43,3 +68,40 @@
- PRD 写成功能说明书而不是业务文档 - PRD 写成功能说明书而不是业务文档
- MVP 边界无限扩大(加了太多"万一需要"的场景) - 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 才能新增

View File

@@ -4,6 +4,37 @@
还原用户从「第一次听说」到「成为忠实用户」到「可能流失」的完整 还原用户从「第一次听说」到「成为忠实用户」到「可能流失」的完整
行为路径,标注每个节点的情绪曲线、决策障碍和流失原因。 行为路径,标注每个节点的情绪曲线、决策障碍和流失原因。
## 第 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 个未验证)
激活时机:上述任一条触发时,列出已知/未知,追问缺失信息,不继续产出。
## 核心追问清单 ## 核心追问清单
### 1. 旅程阶段划分 ### 1. 旅程阶段划分
@@ -35,3 +66,40 @@
- 用自己的行为推演用户(你是超级用户,他不是) - 用自己的行为推演用户(你是超级用户,他不是)
- 只看「用的人」不看「没用的人」(沉默证据偏差) - 只看「用的人」不看「没用的人」(沉默证据偏差)
- 没有区分不同用户类型的旅程差异 - 没有区分不同用户类型的旅程差异
## 存档规则
执行完毕生成报告后,按以下规范存档:
**默认路径**`{项目根目录}/.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 才能新增

122
install.sh Executable file
View File

@@ -0,0 +1,122 @@
#!/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 | 竞品商业分析 |
使用指令时,需读取 `~/.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 ""

View File

@@ -0,0 +1,83 @@
# 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 |
| `event` | 是 | `completed` |
| `ts` | 是 | ISO 8601 时间戳,带时区 |
| `phase` | 否 | 当前阶段: exploration/validation/positioning/pricing/growth |
| `summary` | 否 | 本次产出的核心结论(一句话) |
| `assumption` | 否 | 本次新增的关键假设 |
| `decision` | 否 | 本次做出的关键决策 |
| `conflict` | 否 | 本次发现的冲突(如有),格式:`{冲突假设}:{冲突描述}` |
特点:
- 只追加不修改 — 不会因写入中断损坏历史
- 可重建 — _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)
```
不强制线性,但提供参考。阶段变化是状态更新的核心信号。