Skip to content

v2.17.0-plan.md

Latest commit

 

History

History
206 lines (138 loc) · 4.89 KB

v2.17.0-plan.md

File metadata and controls

206 lines (138 loc) · 4.89 KB
Raw

v2.17.0 — Trust & Curation Hardening

发布日期：2026-08-xx（待定） 主题：Trust & Curation Hardening: lint, governance, regression queries, and source-of-truth cleanup.

一句话目标

把 v2.16.0 的 Remote MCP / README 定位 / 安全热修之后的增长势能，收敛成"可信、可维护、可审计的 failure-memory 网络"。

P0：必须进 v2.17.0

1. Lesson Lint 试运行 ✅

状态： 已完成

  • scripts/lesson_lint.py 已创建
  • 检查项：断链、重复 title、缺少 frontmatter、质量分、过短 lesson
  • 修复 5 个 high severity issues
  • 添加非阻塞 CI job（continue-on-error: true）
  • 当前状态：0 high / 235 medium / 5 low

下一步： 观察几天后改为 --fail-on high 阻塞

2. GX1 贡献→可见闭环 ✅

状态： 已完成

  • PR #968 已合并
  • 新 lesson 统一进入 lessons/contrib/
  • data/lessons.json = 289 entries
  • README = 289
  • STATUS = 289

3. STATUS / ROADMAP 版本漂移清理 ✅

状态： 已完成

  • STATUS.md: v2.15.0 → v2.16.0，日期 2026-08-03 → 2026-08-11
  • STATUS.md: 添加 v2.15.0/v2.16.0 到版本历史
  • ROADMAP.md: 日期 2026-07-29 → 2026-08-11
  • ROADMAP.md: baseline v2.14.0 → v2.16.0，244 → 287 lessons

4. Security hotfix 收尾 ✅

状态： 已完成

  • PR #969 已合并（2026-08-11）
  • Issue #964 已关闭
  • Release notes 包含：
    • MCP path traversal fix
    • Email redaction
    • XSS escape
    • Email validation

P1：应该进，但不阻塞发版

5. "这不是什么"与 Git-backed 定位固化 ✅

状态： 已完成

  • README: "What this is NOT" 表格
  • README: "Git-backed failure-memory" hero
  • README: 竞争分析表（sharing model）
  • docs/CONCEPTS.md: 添加 Git-backed 定位说明
  • docs/trust-semantics.md: 添加反 RAG 说明

6. Duplicate governance ✅

状态： 已完成

  • docs/duplicate-governance.md: 重复 lesson 处理规则
  • 5 种处理动作：merge, link, supersede, reject, ask reproduction
  • 决策流程图
  • 维护者检查清单

7. Regression queries ✅

状态： 已完成

  • data/regression_queries.json: 11 个查询，覆盖 8 个 failure 类别
  • scripts/verify_regression_queries.py: 验证 search 准确性
  • 所有 11 个查询通过验证

覆盖范围：

  • DCO (2 queries)
  • pip timeout (1 query)
  • GitHub token (1 query)
  • database locked (1 query)
  • encoding (1 query)
  • feishu (1 query)
  • fanuc (1 query)
  • MCP setup (1 query)
  • general (2 queries)

用途： 证明 search 真的能找回核心 failure lessons

使用方式：

python scripts/verify_regression_queries.py  # 非阻塞，本地验证

P2：留到后续，不塞进 v2.17

8. Reasoning Memory 字段

目标： lesson 新增字段

  • Alternatives（替代方案）
  • Tradeoffs（权衡）
  • When not to use（适用边界）

状态： 暂不实现，避免 schema 大改

9. 更多 Agent 集成

目标： VS Code / JetBrains / LangChain / CrewAI

状态： 分发增长，非 v2.17 核心质量门槛

10. 学术/benchmark 报告

目标： PR Genius p=0.032 沉淀

状态： 不应成为这版主线

v2.17.0 Definition of Done

发版前满足：

# 1. Lint 通过
python scripts/lesson_lint.py --lessons-dir lessons --fail-on high

# 2. Lesson gate 通过
python scripts/lesson_gate.py <changed lessons>

# 3. Site health 检查
python scripts/site_health.py

并且：

  • README / STATUS / ROADMAP 数字一致（289）
  • data/lessons.json 已重新生成
  • #964 关闭，#969 合并
  • #968 合并或拆出明确 follow-up
  • 没有无关未跟踪文件（如 scripts/pr_genius_manual.py）
  • Lesson lint 0 high issues
  • 非阻塞 CI job 运行正常

Release Notes 草案

v2.17.0 — Trust & Curation Hardening

发布日期： 2026-08-xx

核心变更

  1. Lesson Lint 试运行

    • 新增 scripts/lesson_lint.py：检查断链、重复 title、缺少 frontmatter、质量分
    • 非阻塞 CI job，观察模式
    • 修复 5 个 high severity issues

  2. 竞争分析与定位强化

    • README: "Git-backed failure-memory" hero
    • README: "What this is NOT" 表格
    • README: 竞争分析表（8 个竞品，sharing model 对比）
    • 文档：docs/baseline/competitive-analysis-2026-08-12.md

  3. 版本漂移清理

    • STATUS.md / ROADMAP.md 同步到 v2.16.0
    • Lesson count 统一为 289

  4. 安全收尾

    • #969 MCP path traversal fix 已合并
    • #964 已关闭

贡献者

感谢所有贡献者！

时间线

日期 里程碑
2026-08-12 P0 完成，P1 部分完成
2026-08-13 P1 完成
2026-08-14 观察 lint CI 运行
2026-08-15 发布 v2.17.0

文档创建时间：2026-08-12