2026-06-21_wiki-optimization
Created: 2026-06-21
2026-06-21 Wiki 优化
改动清单
1. SEA 原则概念页(新建)
- 文件:
wiki/concepts/SEA 原则.md - 内容:将 CLAUDE.md §1.5 的 7 条执行底线压缩为三条 SEA 原则
- Source everything — 每个事实都有 raw/ 回链
- Edit surgically — 最小改动,不漂移
- Audit periodically — 每月结构审计 + SHA-256
- 每条原则配有:定义、违反表现、具体做法、成本
- 末尾对比表展示三原则互补关系
2. SHA-256 完整性校验脚本(新建)
- 文件:
scripts/raw-integrity.sh - 支持命令:
generate/verify/status - 设计选择:
- 只校验
.md文件(源文档),不校验 assets/(图片/PDF) - checksums 存
raw/.checksums,commit git - 新增/修改/缺失/完整四种状态报告
- verify 退出码 0=干净 1=有问题
- 只校验
- 首次结果:719 条 checksums,全部匹配,0 修改 0 缺失 0 新增
3. CLAUDE.md 触发规则结构化(修改)
- 摄入工作流 §5 → 增加 TRIGGER when 条件块
- 查询工作流 §6 → 增加 TRIGGER when 条件块
- 清理工作流 §7 → 增加 TRIGGER when 条件块 + 结构/链接/raw/矛盾/知识五类检查拆分 + SHA-256 步骤 + lint 只查结构不判内容说明
4. index.md 信息量增强(重写)
- 全部 27 个页面条目增加
(N 源,MM-DD 更新)指标 - 新增 SEA 原则条目
- 统一描述格式:2-3 行 → 一行精要
- 去除冗余括号内容(放入括号内改为破折号)
5. Promote 晋升工作流(追加)
- CLAUDE.md §8(新增),关注领域顺延至 §9
- 四类晋升路径:短问答→concepts/entities、深度分析→syntheses、对比/分类→references、raw 层→用户手动
- 触发条件:用户说”有价值”、“归档”、“保存到 wiki”时触发
- 晋升后三必须:更新 index、追加 log、保留 outputs 原文不动
- 来源:panmcai/karpathy-wiki schema.md
验证
- SHA-256: 719/719 通过
- index.md: 27 条目全量更新
- CLAUDE.md: 4 处 TRIGGER 规则(摄入/查询/lint/promote)+ 1 处 lint 明细
- scripts/raw-integrity.sh: 生成/校验/状态均通过