diff --git a/CHANGELOG.md b/CHANGELOG.md index 7eae5e9..4e0f6b0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,18 @@ # 圆心商业化工作流（YxStack）变更记录 +## v0.1.0 (2026-05-03) + +### 新增 +- **知识沉淀机制**：每条指令执行完自动存档到 `.yxstack/` +- **回溯历史**：每条指令新增「第 0 步」——执行前先读项目历史记录 +- **跨项目隔离**：不同项目的 `.yxstack/` 互不串读 +- 存档格式：YAML frontmatter + 报告正文 +- ROADMAP 加入 v0.1~v1.0 完整知识沉淀路线 + +### 变更 +- 所有路径改为项目根目录相对路径（`.yxstack/`），不绑定特定项目结构 +- README 新增知识沉淀机制说明 + ## v0.0.1 (2026-05-03) ### 新增 diff --git a/README.md b/README.md index 1f996d6..f83ed56 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,26 @@ 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` 中引用： diff --git a/ROADMAP.md b/ROADMAP.md index 31496d8..f985b83 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -6,26 +6,47 @@ - [x] 8 条命令执行模板（Checklist + 输出结构 + 常见误区） - [x] 全局 CODEBUDDY.md 集成机制 -## v0.1.0 — 指令深度增强 +## v0.1.0 — 知识沉淀机制 + +### 项目级痕迹库（已实现） +- [x] 每条指令执行完毕自动存档到 `{项目}/星图/{阁}/yxstack/` +- [x] 统一格式：YAML frontmatter + 报告正文 +- [x] 文件命名：`{指令}-{日期}-{摘要}.md` + +### 跨项目隔离（已实现） +- [x] 不同项目的 yxstack 历史互不串读 +- [x] 执行指令时模型只读取当前项目的 yxstack/ 目录 + +### 回溯与进化（已实现） +- [x] 每条指令新增「第 0 步：回溯历史」——执行前先读同项目同类历史记录 +- [x] 每条指令新增「存档规则」——执行完按规范存档 +- [x] 报告标注与历史结论的一致性/矛盾/更新 + +### 待完成 +- [ ] 知识冲突自动检测——新结论与历史矛盾时主动提醒 +- [ ] 指令执行时自动识别项目边界，找到对应 yxstack/ 目录 +- [ ] YxStack 使用统计看板——哪个指令用得多、哪个领域踩坑多 + +## v0.2.0 — 指令深度增强 - [ ] 为每条命令增加典型场景案例库 - [ ] 细化各阶段追问权重与优先级 - [ ] 增加"未完待续"处理策略（信息不足时怎么收口） -## v0.2.0 — 命令组合模式 +## v0.3.0 — 命令组合模式 - [ ] `/prd + /pfit` = 完整产品评审流程 - [ ] `/pos + /comp` = 市场定位全景分析 - [ ] `/uj + /metric` = 用户体验指标体系 - [ ] 组合命令的输出融合规范 -## v0.3.0 — 场景自动识别 +## v0.4.0 — 场景自动识别 - [ ] 模型无需用户显式使用 `/xxx`，自动识别当前场景 - [ ] 自动匹配最相关的 1-2 条指令 - [ ] 渐进式引导——先判断在哪个阶段，再切入对应清单 -## v0.4.0 — 扩展生态 +## v0.5.0 — 扩展生态 - [ ] 支持行业定制模板（SaaS、电商、医疗、教育等） - [ ] 集成到 Hookify 体系——通过 prompt 钩子自动匹配场景 diff --git a/commands/comp.md b/commands/comp.md index a548c59..b2a89b3 100644 --- a/commands/comp.md +++ b/commands/comp.md @@ -4,6 +4,14 @@ 从商业模式、价值主张、定价、获客、壁垒五个维度分析竞品， 而不是比较功能列表。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（comp）或相关（pos）的历史记录： +- 如果已有历史竞品分析 → 标注市场变化/竞品动向 +- 如果已有定位分析 → 作为竞品判断的参照系 +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 竞品识别 @@ -46,3 +54,21 @@ - 只比功能不比商业模式——功能可以抄，商业模式抄不走 - 低估「什么都不用」这个竞品——很多用户宁愿忍受也不换 - 静态分析——不看竞品会怎么动 + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/comp-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +``` diff --git a/commands/gtm.md b/commands/gtm.md index cc61724..0310861 100644 --- a/commands/gtm.md +++ b/commands/gtm.md @@ -4,6 +4,14 @@ 设计从 0 到 1 的冷启动策略和推广方案，核心问题是"第一批用户从哪来" 和"怎么让他们留下来并帮你带人"。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（gtm）或相关（pos/comp）的历史记录： +- 如果已有定位或竞品分析 → 作为推广输入 +- 如果已有历史推广方案 → 标注执行结果/调整点 +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 冷启动策略 @@ -41,3 +49,21 @@ - 没有种子用户就做大众推广 - 渠道贪多嚼不烂（盯住一两个打透） - 把「砸钱」当策略而不是助攻 + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/gtm-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +``` diff --git a/commands/metric.md b/commands/metric.md index c202049..d92d5dd 100644 --- a/commands/metric.md +++ b/commands/metric.md @@ -4,6 +4,14 @@ 搭建能真正指导决策的业务指标体系，而不是堆砌指标看板。 含复盘框架，确保从数据中找到可行动的点。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（metric）或相关（prd）的历史记录： +- 如果已有 PRD → 基于 PRD 目标定指标 +- 如果已有历史指标体系 → 对比历史数据趋势 +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 北极星指标 @@ -45,3 +53,21 @@ - 指标太多等于没指标 - 只看总量不看分层（新老用户、付费/免费） - 把观测指标当行动指标（DAU 降了不会告诉你怎么修） + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/metric-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +``` diff --git a/commands/money.md b/commands/money.md index 0abf039..0aa30a4 100644 --- a/commands/money.md +++ b/commands/money.md @@ -3,6 +3,14 @@ ## 命令定位 设计可持续的商业模式和定价体系，打通付费转化链路。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（money）或相关（prd/comp）的历史记录： +- 如果已有 PRD 或竞品分析 → 作为定价输入 +- 如果已有历史定价方案 → 标注迭代点/市场变化 +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 收入模型 @@ -41,3 +49,21 @@ - 定价跟着成本走而不是跟着价值走 - 免费层太大导致没人付费 - 只看注册数不看付费转化率 + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/money-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +``` diff --git a/commands/pfit.md b/commands/pfit.md index 357298f..5d61799 100644 --- a/commands/pfit.md +++ b/commands/pfit.md @@ -4,6 +4,14 @@ 在投入产品资源之前，验证用户所述「痛点」是否真实存在、 是否足够痛、是否值得解决。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（pfit）的历史记录： +- 如果有同类问题的分析结论 → 标注一致性/矛盾/更新点 +- 如果历史结论是 No-Go → 追问"现在的条件跟当时有什么变化？" +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 痛点来源验证 @@ -39,3 +47,22 @@ - 把自己的痛点当成用户的痛点 - 把「不足」当「痛点」（功能不够炫 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` diff --git a/commands/pos.md b/commands/pos.md index 3feaa34..f421ec5 100644 --- a/commands/pos.md +++ b/commands/pos.md @@ -3,6 +3,14 @@ ## 命令定位 明确产品在市场中的独特位置、核心价值主张、以及与竞品的差异点。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（pos）的历史记录： +- 如果有同类产品的定位分析 → 标注与历史定位的一致性/差异点 +- 如果历史定位已被市场验证失败 → 追问"现在的基础条件有什么变化？" +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 价值主张提炼 @@ -34,3 +42,22 @@ - 拿功能当定位（"我们更快"不如"你能多睡一小时"） - 面面俱到等于没有定位 - 对标大厂但不具备大厂的资源禀赋 + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/pos-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +``` + diff --git a/commands/prd.md b/commands/prd.md index b9909c0..30bdb01 100644 --- a/commands/prd.md +++ b/commands/prd.md @@ -4,6 +4,14 @@ 从业务视角写一份可执行的 PRD，聚焦业务逻辑流、角色分工、 数据流转，明确 MVP 的精确边界和功能优先级。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（prd）或相关（pfit/pos）的历史记录： +- 如果已有痛点验证（pfit）或定位分析（pos）→ 作为 PRD 输入，不重复追问 +- 如果已有同类 PRD → 标注与历史版的差异/迭代点 +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 业务目标 @@ -43,3 +51,21 @@ - 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 +--- +``` diff --git a/commands/uj.md b/commands/uj.md index d27311e..3cd9472 100644 --- a/commands/uj.md +++ b/commands/uj.md @@ -4,6 +4,14 @@ 还原用户从「第一次听说」到「成为忠实用户」到「可能流失」的完整 行为路径，标注每个节点的情绪曲线、决策障碍和流失原因。 +## 第 0 步：回溯历史 + +执行本指令前，先检查当前项目根目录下的 `.yxstack/` 目录（如果项目 CODEBUDDY.md +自定义了 YxStack 存档路径，则使用自定义路径），查找近期同指令（uj）的历史记录： +- 如果有同类用户旅程分析 → 标注与历史结论的差异/更新点 +- 如果历史已有流失节点结论 → 追问"当前数据跟当时比有什么变化？" +- 如果没有历史记录 → 跳过，正常执行 + ## 核心追问清单 ### 1. 旅程阶段划分 @@ -35,3 +43,21 @@ - 用自己的行为推演用户（你是超级用户，他不是） - 只看「用的人」不看「没用的人」（沉默证据偏差） - 没有区分不同用户类型的旅程差异 + +## 存档规则 + +执行完毕生成报告后，按以下规范存档： + +**默认路径**：`{项目根目录}/.yxstack/uj-{日期}-{一句话摘要}.md` +（如果项目 CODEBUDDY.md 自定义了 YxStack 存档路径，优先使用自定义路径） + +**格式**：YAML frontmatter + 报告正文 +```yaml +--- +title: "{一句话标题}" +author: "{执行者}" +date: "{YYYY-MM-DD}" +tags: ["关键词1", "关键词2"] +status: draft # draft → validated → outdated +--- +```