qiukai/yxstack-skill
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
v0.3.0
yxstack-skill/CHANGELOG.md
开阳星 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

5.5 KiB
Raw Permalink Blame History

圆心商业化工作流（YxStack）变更记录

v0.3.0 (2026-05-03)

新增

  • /learn 指令（commands/learn.md）：摄入外部业务材料，解析并汇总为结构化知识库
    • 支持全类型材料（PDF/DOCX/XLSX/CSV/PPT/HTML/图片OCR/JSON）
    • 按 8 模块归类（行业背景/市场数据/竞品全景/目标用户/关键约束/待验证假设/知识冲突/材料溯源）
    • 子命令：/learn <路径>（摄入）、update（增量）、show（摘要）、prune（修剪）
    • 对标 gstack /learn 的 prune 机制（过期检测 + 矛盾检测 + 置信度评估）
  • 自动发现（Operational Self-Improvement）：8 条命令执行完毕后自动记录高价值洞察
    • 追加到 _timeline.jsonl，type: insight/decision/pitfall
    • 判断标准：「下次执行同类分析时，这个洞察能省时间吗？」
    • 对标 gstack 各技能 SKILL.md 中的 Operational Self-Improvement 段
  • _timeline.jsonl 扩展：新增 type/confidence/key 三个字段，支持学习记录去重和检索
  • 8 条命令第 0 步增强：
    • 「加载知识库」— 读取 learn/knowledge.md
    • 「加载近期学习」— 检索 _timeline.jsonl 高置信度记录
  • templates/state_template.md 新增 learn/knowledge.md 数据结构说明

设计参考

  • gstack /learn 的 JSONL append-only + key+type 去重 + confidence 进化模型
  • gstack 的 Operational Self-Improvement + Capture Learnings 双层写入机制

路线图调整

  • ROADMAP v0.3.0 改为「/learn 知识库 + 自动发现」（原「指令深度增强」后移至 v0.4.0）
  • 后续版本顺延：v0.4.0 指令深度增强 → v0.5.0 命令组合模式 → v0.6.0 场景自动识别 → v0.7.0 扩展生态 → v1.0.0 评测体系

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 增加验证标准列 + 假设状态取值规范

设计参考

  • 对比 gstack（YC 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)

新增

  • 核心框架：README + 8 条命令执行模板
  • 命令模板含 核心追问清单 + 输出结构 + 常见误区
  • 全局 CODEBUDDY.md 集成机制
  • ROADMAP 路线图
  • MIT 开源协议

命令清单

指令 文件
/pfit commands/pfit.md
/pos commands/pos.md
/uj commands/uj.md
/prd commands/prd.md
/money commands/money.md
/gtm commands/gtm.md
/metric commands/metric.md
/comp commands/comp.md

维护方

  • 筑基阁（开阳星）· 天机阁
Reference in New Issue View Git Blame Copy Permalink