文档编辑规范技能书

适用人群

适合：要整理报告、方案、说明书或演示材料的人、要把零散文档改成更适合交付、汇报或归档版本的人、要先完成第一轮文档整理再交给同事审阅的人。

技能介绍

数据库变更和配置变更的递增式管理规范。使用场景：(1) 创建/修改数据库表结构时生成 Vx__xxx.sql 文件，(2) 修改应用配置时更新 CHANGELOG_CONFIG.md，(3) 需要回滚方案时编写 rollback/Vx__rollback.sql，(4) 文档超过500行时按年份/版本拆分归档。触发关键词：SQL变更、数据库迁移、配置管理、CHANGELOG、版本控制、回滚脚本、数据库变更记录。

本技能书专注于数据库变更和配置变更的递增式管理，确保每次改动都有据可查。

业务背景和落地案例

当团队需要数据库变更时，可以先用文档编辑规范技能书完成第一轮处理。常见做法是把相关文件、网址、素材或配置交给它，先产出初版结果，再由人工确认和继续推进。

能做什么

• 每次数据库变更都有完整的SQL脚本。
• 每次配置修改都有清晰的记录。
• 支持版本回滚和追溯。
• 文档过大时自动拆分。
• SQL文件按版本递增（V1, V2, V3…）。
• 配置变更按时间记录。
• 每次变更独立可追溯。

安装方法

方式 1：对 OpenClaw 说（不用写代码）

适合：OpenClaw、Codex、Kimiclaw、Windsurf、Trae、华为 CodeArts。

直接对 OpenClaw 说：

帮我安装一个叫 文档编辑规范技能书 的 Skill。
如果安装时需要精确名字，就用 base-agents-workspace-doc-changelog。
装好以后，先用它帮我处理一遍当前任务。

如果需要手动安装，可以用这条命令：

clawhub install base-agents-workspace-doc-changelog

方式 2：导入 MD 安装

适合：腾讯Workbuddy、百度Duclaw、字节Arkclaw、智谱Autoclaw、科大讯飞Astronclaw。

1. 找到这条 Skill 自带的 Markdown 文件，通常就是它的 SKILL.md 或同名 .md 文件。
2. 把这个 Markdown 文件导入到你的产品里。
3. 导入完成后，直接对 AI 说：

用刚刚导入的文档编辑规范技能书，先帮我处理当前任务。

备注：这一种本质上是导入一个 Markdown 文件，给知道安装包里有 .md 文件的人即可。

方式 3：代码安装

适合：Claude Code、Cursor、通义灵码、文心快码。

这条 Skill 没有整理出稳定的命令行安装写法，建议优先用方式 1 或方式 2。

使用步骤

1. 先选上面 3 种方式里，自己最容易完成的一种。
2. 安装完成后，直接对 OpenClaw 说：“用文档编辑规范技能书帮我处理当前任务。” 先让它自己跑一遍就可以。
3. 如果你已经有明确文件、网址、目录或数据，再把它补给 OpenClaw，让它只处理这一部分。
4. 先看第一轮结果，再决定要不要追加条件、缩小范围或继续执行下一步。
5. 如果这条 Skill 确实好用，就把它保留在常用列表，后面重复任务直接复用。

你需要准备什么

• 与你当前任务相关的文件、网址、目录或数据。
• 要处理的文档、报告或资料文件。
• 希望得到的整理方向或输出格式。
• 需要重点保留或重点修改的部分。
• 如果这条 Skill 依赖外部服务，还要准备对应账号权限或可用凭证。

你会看到什么结果

• 整理后的文档或报告结果。
• 提炼好的重点内容。
• 可继续编辑或交付的材料。

风险提示

• 涉及 API Key、Token 或其他凭证时，先确认保存方式和权限边界。
• 如果会修改外部系统、本地文件或线上环境，建议先在测试环境跑最小流程。

来源信息

• 公开页面地址: https://agentskillsrepo.com/skill/yangmour/base-agents-workspace-doc-changelog
• SKILL.md 下载地址: https://agentskillsrepo.com/skill/yangmour/base-agents-workspace-doc-changelog/download