skillhub/docs/archive/_meta/contribution-guide.md

档案贡献指南

目标

档案库应当容易扩展，而不是一开始就要求贡献者把所有事情都想清楚。推荐的写法是：

• 条目小而清晰，并且互相有链接
• 日期明确
• 来源引用直接可见
• 尽量减少重复

新增材料

1. 如果材料还没准备好归类，先放进 inbox/。
2. 当一份材料未来可能被引用时，创建对应的 sources/ 条目。
3. 更新相应月份的 timeline/ 文件。
4. 只有在“综合整理”本身有价值时，才把材料提升到 milestones/、decisions/、contributors/ 或 narratives/。

编辑规则

• 优先补充带来源的事实，不要凭记忆写大段概述。
• 一个文件只聚焦一个主题。
• 尽量链接已有文档、PR、issue 或提交，而不是复制大段原文。
• 如果确实需要新的档案分类，先更新 _meta/taxonomy.md。

如何处理不完整信息

• 用 status: seed 表示第一版骨架，且已有可验证锚点。
• 用 status: draft 表示内容还不完整，但已经可以阅读。
• 用 status: curated 表示结构和证据已经足够扎实，可被后续复用。

适用范围

适合进入档案的内容：

• 一个重要想法首次出现的时刻
• 改变方向、范围、架构或工作流的里程碑
• 能解释某个选择为何发生的贡献者讨论
• 影响项目传播或认知的外部提及

除非确有需要，否则不建议完整保存以下内容：

• 没有摘要的原始聊天导出
• 冗长 PR 描述的重复拷贝
• 文章全文复制
• 低信号的运维噪音

复核清单

在把一条记录视为稳定之前，请检查：

• 日期是否明确
• 文件类型是否正确
• 是否至少有一条具体来源
• 敏感信息是否已经脱敏或改写为摘要
• 文件是否链接到了档案中的下一处相关内容