Wiki 未分类

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: 生成/校验/状态均通过

输入关键词开始搜索