每周更新清单
用于维护 AI 文档与实践基线,建议每周固定半天执行一次。
A. 信息更新(Sources)
1. 平台变更
- 检查 OpenAI、Anthropic、Google 官方文档更新日志。
- 记录 API 能力、模型行为、限额与价格变化。
2. 治理与合规
- 检查 NIST、OWASP、EU AI Act 官方页面是否有新条款或解释更新。
- 更新时间线与适用范围说明。
3. 研究进展
- 补充高质量论文或实证研究。
- 标注“可复现性”和“与当前业务相关性”。
B. 文档更新(Docs)
1. 内容陈旧检查
- 清理失效链接。
- 删除不再适用的建议。
- 给关键结论添加时间戳。
2. 结构维护
- 检查首页与侧边栏路径是否清晰。
- 新增内容必须进入“推荐阅读路径”或“角色路径”。
3. 质量门槛
- 每个核心页面都应有参考来源。
- 避免无来源的强结论。
C. 工程验证(Quality Gate)
每次改动后执行:
bash
pnpm --filter docs lint
pnpm --filter docs typecheck
pnpm --filter docs build通过标准:
- lint 0 错误。
- typecheck 0 错误。
- build 成功且无断链。
D. 运营复盘(Adoption)
1. 读者反馈
- 收集“哪页最有用、最难懂、过时”。
- 将反馈映射为具体改动 issue。
2. 使用指标
- 跟踪高频访问页面与跳出页面。
- 识别需要补案例或模板的章节。
3. 决策输出
- 本周保留:继续有效的实践。
- 本周修订:需要更新的结论。
- 下周计划:新增主题与负责人。
E. 模板化产出(建议)
每周产出一个简短周报(建议 1 页):
- 本周新增来源(含链接)。
- 本周更新页面(含变更点)。
- 本周风险提醒(技术与合规)。
- 下周优先级(P0、P1、P2)。
这样可以保证文档不是“一次性整理”,而是持续进化。
F. 角色分工(开发者 / 产品经理)
开发者负责
- 技术事实更新:模型能力、工程实践、性能与成本数据。
- 评测与门禁状态:回归结果、告警阈值、回滚条件。
- 文档技术准确性审查:示例可执行、命令可运行、链路可复现。
产品经理负责
- 业务目标和 KPI 变更同步。
- 用户反馈归因:哪些问题是体验问题,哪些是能力问题。
- 风险与合规节奏管理:高风险场景、对外说明、灰度策略。
共同确认
- 本周是否允许放量。
- 本周是否需要新增人工复核策略。
- 下周迭代的 P0 事项与负责人。
