推进
首页 / 学习
learning HOW_TO_LEARN.md更新 2026-09-22

怎么学 + 知识卡片合同

权威:见 CURRENT_STATE.md · 更新:2026-09-21
主卡入口:cards/index.md · 评审原料:sources/raw/2026-09-21-wiki-knowledge-audit.md

流程(固定)

新材料入库 sources/raw/
    ↓
蒸馏 claims/(按来源 · 条条可复核)并/或 升级/新建 cards/ 主题主卡
    ↓
若改变方向 → 只改 CURRENT_STATE.md(唯一权威)
    ↓
记一条 learning/log.md
  • 查问题: 默认走 cards/(问题式主卡)
  • 查某份报告说了什么: 走 claims/ + sources/
  • 查当前拍板: 只信 CURRENT_STATE.md
  • 不上本阶段: 搜索引擎、向量库(先主卡与导出)

硬规则(W07 等)

  • CURRENT_STATE 唯一权威;Wiki 影子完整,但不是第二状态源
  • 只进带复核条件的 claim / 卡片;禁止贴研究报告全文当知识
  • 白话、决策导向;推断不得写成事实
  • 厂商介绍 ≠ 独立效果验证;开源未在友车环境实测
  • 审批 ≠ 科学事实;负责人改意见写在决策变更触发,不写进证据复核
  • 同一报告多摘要 = 一条来源链,不算多证据
  • 同源摘要 / 音频转写 / 站点蒸馏出现三次仍可能一条来源,不算多证据
  • 复核条件分层: 事实真伪用新证据触发;选型用重议/评测触发;用户批准 ≠ 事实真伪(批准只改 decision_status)
  • 原料 ≠ 结论;路径一律相对链接;UTF-8 markdown

四种卡

类型含义何时用
概念术语是什么、不是什么统一产品语言
判断对现状/方向的主张需要证据态支撑的结论
决策已选、待选或否决的路线需要决策态与变更触发
实践怎么做、门槛、边界HITL、接入、试点节奏等

一张卡一个稳定 id(如 K-001);title 用问题式。

卡片字段合同

每张主卡(cards/K-*.md)须含:

字段说明
id稳定 ID,如 K-001
type概念 / 判断 / 决策 / 实践
title问题式标题
short_answer白话短答(一两句)
scope适用边界(场景/阶段/系统)
evidence_status证据状态(见下)
decision_status决策状态(见下)
verification_status验证状态(见下)
evidence_review_trigger何种新证据构成反例(禁止写「负责人改意见」)
decision_change_trigger何种决策/审批事件触发重审或改口(可含负责人书面改口)
source_refs精确到页/§ 或 claim 锚点;相对路径
relations相关卡 ID 或其他页
version卡片版本
updated_atYYYY-MM-DD
owner维护责任(如 AI CDP)

机器导出见 site/agent/cards.json(由 build_site.py 解析 cards/*.md,跳过 index.md)。

证据状态(evidence_status)建议枚举

值含义
论证中仍在推理,缺设计依据
有设计依据有方案/报告支撑,非实测
缺本地实验外部或作者主张有,友车未测
已验证(写明范围)在声明范围内有实测/现网证据

决策状态(decision_status)

值含义
草稿未进入权威摘要
待批准已写入权威方向,待亮哥/业务批准
已批准明确批准或入库硬约束
已否决明确不做
需重审触发条件已出现,等待再裁决

验证状态(verification_status)

值含义
未测无友车/试点实测
试点中试点进行中
已验证(范围)写明城市/门店/指标范围
失败实测未达标(保留反例)

提醒: decision_status=已批准 只说明拍板,不等于 verification_status=已验证。

旧 claim 字段 → 三态映射

旧 claim 最小字段仍有效;升级主卡或补字段时按下列映射:

旧字段新位置
判断title(改问题式)+ short_answer
标签可保留在正文;类型归入 type
可信度影响 evidence_status 初值(一手→偏已验证候选;媒体/待核实→有设计依据或缺本地实验)
来源source_refs(尽量精确到 §/页)
复核条件拆成 evidence_review_trigger;若原文是「亮哥改口」类 → 挪到 decision_change_trigger
打到relations + 正文链接

未升级的 claim 文件可继续按来源存放;默认问答入口改为 cards/。

标签(claim 蒸馏仍可用)

标签含义
趋势增强加强已有方向
新变量新出现、需纳入考量
待验证听起来有用,缺证据
噪音降权过热/营销话术,降权

可信度(claim 蒸馏仍可用)

级含义
一手自家现网/实测/法务确认
媒体公开报道或厂商文档(非效果验证)
传闻二手转述
待核实未核验(含 Workshop 404、开源未实测)

Claim 最小字段(按来源蒸馏时)

  1. 判断(一句)
  2. 标签
  3. 可信度
  4. 来源(raw 相对路径或外链,尽量到 §)
  5. 复核条件(证据反例;负责人改口另写决策变更)
  6. 打到的概念 / 场景 / 主卡

什么时候上浮共享 concepts

  • 方向已在 CURRENT_STATE 拍板(或明确「待确认」但需跨 agent 看见)
  • claim/主卡已带复核条件,且不只服务本产品一页
  • 上浮后在共享 concepts 页链回本库 sources,不复制 raw 全文