HINTS — 写作约定与命名规则

目录结构

• wiki/concepts/_context.md — 概念页上下文
• wiki/entities/_context.md — 实体页上下文
• wiki/syntheses/_context.md — 综合页上下文
• wiki/references/_context.md — 参考页上下文
• 进新目录前先读 _context.md 判断是否值得深入

命名规则

页面类型	命名格式	示例
concept	TitleCase	上下文管理与 Harness Engineering.md
entity	TitleCase	Claude Code.md
synthesis	kebab-case	AI 创业与 OPC.md
reference	kebab-case	raw-主题索引.md
changelog	YYYY-MM-DD_action-title.md	2026-06-21_wiki-optimization.md

Frontmatter 字段

---
title: "页面标题（人类可读）"
created: YYYY-MM-DD
last_updated: YYYY-MM-DD
source_count: N          # 引用的独立源文件数
type: concept            # concept | entity | synthesis | reference
tags: [tag1, tag2]       # 小写 kebab-case
confidence: 0.85         # 4 因子数值评分 0.30-0.95（见下方公式）
lifecycle: reviewed      # draft | reviewed | verified | stale | archived
entity_type: concept     # [实体/概念用] concept | tool | person | org | project | api | library
---

置信度评分公式

confidence 基于 4 因子计算，由脚本自动维护：

因子	分段	分值
source_count	≤1 / 2-5 / 6-15 / 16-30 / 31-50 / ≥51	0.40 / 0.55 / 0.70 / 0.80 / 0.85 / 0.90
recency	<7d / 7-30d / 31-60d / >60d	+0.05 / 0 / -0.05 / -0.10
final	clamp(base + recency, 0.30, 0.95)	—

source_quality 和 cross_refs 因子的数据当前未结构化采集，暂不纳入计算。

生命周期

draft（新/单源）→ reviewed（多源已验证）→ verified（大页已审计）→ stale（陈旧）→ archived（归档）

格式约束

• 内部链接：[[wiki/subdir/文件名]]，不加 .md 后缀
• 来源引用：[[raw/路径/file.md|来源: file.md]]，多个来源间加空格
• 矛盾标记：> 矛盾：[声明A] vs [声明B] 来自 [来源]，保留双方
• 图片资源：![[raw/assets/文件名.png]]
• raw/ 不可变：永远不修改 raw/ 下的任何文件

编辑原则

• 优先更新已有页面，不新建孤立页
• 单次改动不重写大片——来源、反链和结构会一起漂
• 更新所有受影响的交叉引用页面
• 禁止把查询输出直接覆盖 wiki 正文——outputs/ 归查询，wiki/ 归编译