# Agent 内容发布检查清单

版本：1.0.0 · 2026-09-10
作者：duange.ai · 可复制、修改并用于自己的项目；转载请保留来源。
配套说明：https://duange.ai/resources/agent-content-kit/

适用于由 Agent 协助编辑 Markdown 内容的工作流。字段和命令示例对应 duange.ai；用于其他项目时，请替换为该项目的约定。

## 1. 明确本次改动

- [ ] 用一句话说明读者的问题、适用对象和预期收获。
- [ ] 说明是新文章、轻微勘误、实质更新，还是替代旧文章。
- [ ] 核对现有内容，避免重复主题或相互矛盾的结论。

## 2. 对照依据检查正文

- [ ] 对每个关键事实标注对应的原始来源或实际验证结果。
- [ ] 命令说明运行环境、前提、预期输出和失败时的处理方式。
- [ ] 区分实际执行结果、示例和推测；不要将来源可访问当作事实已验证。
- [ ] 删除无法证实的客户、评价、性能数字与“已上线”等声明。
- [ ] 检查是否误含凭据、私人信息或未获授权的第三方内容。

## 3. 保持内容结构一致

- [ ] 标题、摘要与正文一致，标签描述主题，kind 描述阅读形式。
- [ ] 草稿保持 draft: true；发布时间用实际计划日期，不沿用模板日期。
- [ ] 实质更新填写 updatedDate 和 revisionNote，不为排序刷新日期。
- [ ] 系列标题一致、order 唯一；不要链接尚未发布的章节。
- [ ] 已发布文件改名时保留旧地址台账，并设置直达最终地址的 301。
- [ ] readingAction 只指向与正文相关的有效入口；不需要时省略。

## 4. 本地验收

- [ ] 阅读完整差异，确认没有改动任务范围之外的文件。
- [ ] 运行项目规定的构建、测试和站内链接检查。
- [ ] 在手机宽度查看正文、目录、代码与表格，检查是否溢出。
- [ ] 手动走一次文章 → 系列/资料/项目的路径。
- [ ] 确认草稿、未来内容不会出现在生产列表、RSS、sitemap 和分享图中。

本站示例命令：

```sh
pnpm build
pnpm test
pnpm maintain
```

pnpm maintain 输出提醒，不表示编辑工作已经完成。CI 不可用时仍执行本地检查。

## 5. 发布与记录

- [ ] 已发布文章运行 pnpm routes:record，将地址台账一起提交。
- [ ] 记录通过的检查、未解决问题，以及实际发布版本。
- [ ] 部署后核对目标域名内容；本地成功不表示公网已成功。
- [ ] 对外分发前检查正式链接，渠道 UTM 仅用于外部传播。
- [ ] 仅在真实发布后记录渠道地址与时间，不把文案草稿记成发布成功。

## 一次验收的交付格式

- 本次目标：
- 修改文件与关键变化：
- 依据与实际验证：
- 构建/测试结果：
- 手动阅读检查：
- 未解决问题：
- 发布状态：未发布 / 已发布（附实际版本与 URL）

勾选只表示完成了对应动作，不代替事实判断、人工审核或对外发布授权。