CONTRIBUTING.md

贡献入口

本页只是手工维护知识树的短入口，不再承载全部细则。先按任务选一篇专题，不要每次落盘都读完整套规范。

本目录以 zuiho-kai/claude-workflow-starter 的贡献流程为内容和目录规范来源； vendored 后的批量整理还必须遵守 知识重组计划 的 owner-scoped inventory、union-first 和证据保留约束。SCHEMA.md 只补 frontmatter、标签和溯源元数据，不能据此发明第二套知识结构。

向 zuiho-kai/claude-workflow-starter 这个公开上游提交 commit 时使用 DCO sign-off（git commit -s）。第三方接入后按自己的贡献政策保留、修改或删除这条要求。

正在做什么

任务	只需继续读
判断内容放 general/、repos/、component、model 还是 local/	目录与归属
新增 _index.md、rules.md、architecture.md 或普通页面	页面与索引
从 PR/review 复盘并提炼规则	复盘与规则摄取
文件太长、目录太挤、dev 要拆前后端或模块/模型长大	何时拆分
新增、移动、重命名、删除 Markdown，或准备提交	同步与校验

所有专题入口见 contributing 索引。

最短落盘流程

1. 写任何正文前先完成写入前 owner 凭证：先确定最近 owner 和目标目录，再选择 rules.md、architecture.md 或 guides/；已有文件不能反过来证明 owner。
2. 按上表只选一篇与当前动作匹配的专题；位置不确定时选择 目录与归属，不要为了保险横向通读。
3. 写正文，同时更新最近 _index.md；父级只增加路由，不复制正文，不预建空目录或占位页面。
4. 用户要求复盘时，动笔前先完成语义分流台账，不能先打开 rules.md 再把不适合的内容往外搬。硬门禁进 rules.md，稳定职责和数据流进 architecture.md，非硬门禁方法进 guides/，一次性历史默认不落盘；incident 只有通过三项准入门禁才创建。
5. 对照本页“交付前五项”检查链接、索引、隐私和拆分阈值，然后运行：

python tools/check_knowledge_tree.py

不能放宽的 P0

• 只保留一套正式知识树，不建 _private/、兼容副本或第二套私人索引。
• 机器地址、账号、cache、venv、token、密钥和用户绝对路径只属于 Git 忽略的 local/；密码、token 和私钥正文不写入文件。
• 一条知识只有一份正文，其他入口只链接；不复制类似规则。
• 长期知识只写本仓库的 general/、repos/ 和贡献规范，不推进系统、全局或个人 memory。
• 仓库、模块、模型和机器规则不互相继承；当前任务只加载真正命中的 owner。
• 新增、移动、重命名、拆分或删除 Markdown 时，必须在同一修改中更新索引和所有链接。
• PR/review 学习只能落可执行规则：完整 diff、评论、thread、commit 和回放输出只在 整理时进入 Git 忽略的临时目录；批次结束必须删除。正式树只更新最近 component 或 model owner 的 rules.md 及必要索引，不新增 PR case/history/result/incident 页面。
• 非 PR 学习的既有 guide/architecture 继续按原 owner 维护；不得把不同模型、组件、 benchmark 和 review 内容压成一篇 catch-all 页面。
• 评测 cases、hidden labels、predictions、judgments 和 run reports 属于 eval/， 不得混入产品知识树或 adapter 默认 briefing。

交付前五项

• 写入前 owner 凭证完整，位置符合内容 owner，没有把工作主题和代码模块套娃。
• 最近 _index.md 能找到唯一正文，旧路径没有残留有效链接；父级和其他入口只链接，没有复制正文。
• 语义分流台账已完成；rules.md 候选逐条通过 purity audit，方法、架构和历史证据没有混入。
• 没有公开机器信息、凭据、私人路径或本地临时产物。
• python tools/check_knowledge_tree.py 和 python tools/check_wiki_lint.py 都通过，并已检查当前完整 diff。