首页 / 学习
怎么学 + 知识卡片合同
权威:见 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_at | YYYY-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 最小字段(按来源蒸馏时)
- 判断(一句)
- 标签
- 可信度
- 来源(raw 相对路径或外链,尽量到 §)
- 复核条件(证据反例;负责人改口另写决策变更)
- 打到的概念 / 场景 / 主卡
什么时候上浮共享 concepts
- 方向已在 CURRENT_STATE 拍板(或明确「待确认」但需跨 agent 看见)
- claim/主卡已带复核条件,且不只服务本产品一页
- 上浮后在共享 concepts 页链回本库 sources,不复制 raw 全文