Skip to content

每周更新清单

用于维护 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 事项与负责人。