Knowledge Project
将知识工作组织为自描述项目——任何 Agent 打开即可理解和继续，无需外部记忆系统；并让项目里的规则随工作演化，而不是膨胀到没人遵守。
本文件是常驻层：每次触发都成立的原则、纪律与路由。具体做法按 §路由 读 references/ 下的对应文件，只读本次意图需要的那几个。
Philosophy
核心理念：项目本身携带完整上下文，项目目录是唯一的持久化载体——换 Agent、换平台、清空记忆、本 skill 未安装，打开项目目录即可继续。
设计原则：
- 纯文件 + 约定：markdown + YAML frontmatter，零工具依赖，git 友好
- 自包含：每个文档独立可理解，不以读过别的文档为前提
- 最小约束：只规定互操作必需的结构，其余由项目自行演化
- 写的人花 2 分钟，读的人省 20 分钟：信息密度优先，格式服务检索
- 单一权威源：规则只在一处定义，其他文件引用不复述
格式基础：Open Knowledge Format (OKF) v0.2 —— 知识用 markdown + YAML frontmatter 目录表示，人和 Agent 用同一份文件。字段约定与有意偏离见 format.md。
硬约束
- 项目文件即记忆：项目的所有上下文落在项目文件中（AGENTS.md、log.md、内容文件），不写入 Agent 自身的 memory。
- 产出物不得反向依赖、不得引用本 skill：由本方法论创建或维护的项目，其自足性不得以"本 skill 在场"为前提；项目文件中不出现本 skill 的名字，也不留指向任何外部方法论的指针——无例外。判据与理由见 seed.md §关键约束。
- 进展随工作落地：进展、决策、文件元数据随工作产生同步写入。最终检验：结束工作时，log.md 最后一条的"下一步"足以让任意 Agent 从零接手。
- 按影响决定改进权限：项目内小范围、可回退且不改变目标或质量要求的规则调整，可自主执行并记 log；其余改进走 proposal（诊断 → 提案 → 用户确认 → 执行 → 记 log）。本 skill 方法论的修改仍走 Meta-Iteration。
Epistemics
知识工作的认知纪律。贯穿所有工作流，优先级高于具体流程步骤。第 1、3 条以精简版内联进种子、第 4 条对应种子的"感知偏差与对齐"——本 skill 未被触发时，项目照样遵守。
- 基于证据：判断、选择、结论须追溯到可观测的依据。没有证据时承认不确定，而非填充看似合理的假设。委派或其他 Agent 的产出同样是候选输入而非既定事实——引用它做不可逆动作（删除、归档、改权威源）前先复核源头。已核验且未改动的信息，可在实际核验范围内初步信任；需要核查时，范围限于变动内容及当前任务直接依赖的部分。
- 在行动点决策：不提前锁定依赖未知信息的决定。确定方向，开始行动，让工作本身产生下一个决策点。
- 完整执行：不跳步骤，不用"以此类推"代替实际工作。产出是做出来的，不是规划出来的。
- 对齐优先于执行：目标有歧义、存在矛盾、或涉及方向性取舍时，先澄清再行动。推断可以替代追问，但推断必须显式呈现供纠正——不用默认值静默填充。
路由
按意图只读需要的文件，顺序即阅读顺序：
| 意图 | 读 | 要点 |
|---|---|---|
| 创建新项目 | workflows.md §Initialize → structure.md → seed.md → format.md | 选规模、写规则文件并内联种子、建 log 与首个内容文件 |
| 恢复/继续项目 | 本文件 §Resume | 已有种子的项目按它自己的 AGENTS.md 执行即可 |
| 整理、优化、健康检查 | workflows.md §Health Check | 按诊断结果转 Milestone Review 或 Distill（同文件） |
| 日常维护：写 log、frontmatter、决策记录，关闭事项 | workflows.md §Daily Operations → format.md | |
| 沉淀探索期产物 | workflows.md §Distill | |
| 规划文件组织、判断一条信息该写在哪 | structure.md | |
| 新增/删除/固化规则、规则膨胀、立门禁或评估门禁 | governance.md | |
| 回顾或改进方法论本身 | governance.md §Meta-Iteration | 须用户显式触发 |
除 Resume 外，触发时顺带对照 Health Check 清单扫描项目现状，发现可改进项时向用户提出。
Resume
新 session 阅读协议：
- AGENTS.md → 理解项目结构和约定
- 任务路由表（如有）→ 按本次任务加载对应的任务层规则
- 定位当前事项并读取其状态，任务清单如有则用
- 按需查该事项的相关日志 → 补充进展与阻塞；无独立事项文件时从日志恢复
- 进入具体工作
若 log 描述与当前文件实际状态冲突，以文件为准，更新过时描述。
日常感知
在项目中工作时，持续感知结构摩擦并推动改进：
- 发现规则与实际操作不一致 → 提出 AGENTS.md 修改建议
- 发现导航不够高效 → 提出结构调整
- 发现重复模式 → 提出新规则或模板（新增前先过 governance.md §规则的准入与退出）
何时启动正式的结构性迭代，见 governance.md §Self-Iteration。
Boundaries
本 skill 不是：
- 记忆系统（不做向量检索、不跨项目同步状态）
- 重编排 / 多 agent 调度器——但轻量结构化任务资产（复杂事项拆 需求/设计/实施清单/决策记录）是标准项目的一等组成，见 structure.md §Customization
- git 的替代品（版本管理就是 git）
- 强制模板（最小约束，项目自行演化）
