Menu
dap-util 发布流程，按步骤完成版本号更新、源码打包、文档更新、changelog 更新、文档打包、README 更新、npm 发布，每步均需用户确认后执行。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | release |
| description | dap-util 发布流程，按步骤完成版本号更新、源码打包、文档更新、changelog 更新、文档打包、README 更新、npm 发布，每步均需用户确认后执行。 |
执行此 skill 时，严格按照以下步骤逐步完成发布工作。每一步执行前必须先向用户确认，用户明确同意后再执行，不得跳步或合并执行。
首先读取 package.json 中当前的 version 字段，然后根据当前版本类型自动推算候选版本，使用 AskUserQuestion 工具以选项形式呈现给用户（必须包含"其他"选项供用户自定义输入）：
若当前版本为 beta 版（如 x.y.z-beta.N）：
x.y.z-beta.(N+1)（beta 版本号 +1）x.y.z（发布为正式版本）若当前版本为正式版（如 x.y.z）：
x.y.(z+1)-beta.1（下一个补丁版的 beta）x.y.(z+1)（下一个补丁正式版）x.(y+1).0-beta.1（下一个次版本的 beta）获取用户选择后，直接使用 Edit 工具修改 package.json 中的 version 字段，无需再次确认。完成后展示修改结果，直接进入下一步。
向用户确认：
即将执行
npm run lib打包最新源代码，是否继续？
用户确认后执行：
npm run lib
向用户确认：
即将根据
src/目录下的最新源码，检查并更新docs/目录下的文档，是否继续？
用户确认后，执行以下操作：
读取 docs/guide/install.md，将文件中所有出现的旧版本号（{当前版本号}）替换为新版本号（{新版本号}），包括：
使用 replace_all 模式一次性替换所有出现的旧版本号。
逐一读取以下源码文件，提取准确的 API 信息：
src/color.ts：颜色相关工具方法的真实签名src/common.ts：通用工具方法的真实签名src/data.ts：数据处理相关方法的真实签名src/element.ts：DOM 元素相关方法的真实签名src/event.ts：事件相关方法的真实签名src/file.ts：文件相关方法的真实签名src/number.ts：数字处理相关方法的真实签名src/platform.ts：平台判断相关方法的真实签名src/speech.ts：语音相关方法的真实签名src/string.ts：字符串处理相关方法的真实签名src/index.ts：对外导出的内容对 docs/ 目录下以下文件逐一核查：
docs/guide/modules/color.md：颜色模块文档docs/guide/modules/common.md：通用模块文档docs/guide/modules/data.md：数据模块文档docs/guide/modules/element.md：元素模块文档docs/guide/modules/event.md：事件模块文档docs/guide/modules/file.md：文件模块文档docs/guide/modules/number.md：数字模块文档docs/guide/modules/platform.md：平台模块文档docs/guide/modules/speech.md：语音模块文档docs/guide/modules/string.md：字符串模块文档docs/guide/quick-start.md：快速上手示例docs/guide/introduction.md：介绍页docs/guide/install.md：安装说明重点核查：
完成后向用户汇报：修改了哪些文档、具体改了什么，直接进入下一步。
向用户确认：
即将根据 git 提交记录自动生成版本
{新版本号}的更新说明并写入docs/changelog.md，是否继续？
用户确认后，执行以下操作：
执行以下命令，获取自上一个版本 tag 以来涉及 src/ 目录的所有 commit：
git log $(git describe --tags --abbrev=0)..HEAD --oneline -- src/
若没有任何已有 tag，则获取全部涉及 src/ 的提交：
git log --oneline -- src/
同时获取以下两部分变更，综合归纳更新要点：
src/ 的提交记录git diff HEAD -- src/ 获取当前工作区中 src/ 下尚未提交的变更将两部分内容合并分析，只根据涉及 src/ 目录的变更归纳整理更新要点，文档、配置、脚本等变更不计入 changelog。合并相关变更、过滤无实质意义的内容（如"fix typo"、"代码格式化"等），生成 changelog 条目列表。若两部分均无任何 src/ 相关变更，则写入"代码优化，修复部分问题"作为兜底条目。
读取 docs/changelog.md，在文件的 frontmatter 结束标记（---）之后、第一个版本条目（## v...）之前插入新版本条目，格式与文件中现有条目保持一致：
## v{新版本号} <Badge type="tip" text='{YYYY.MM.DD}' />
- {更新内容1}
- {更新内容2}
日期使用执行当天的实际日期。完成后向用户展示新增的 changelog 内容，直接进入下一步。
向用户确认：
即将执行
npm run docs:build打包最新文档，是否继续？
用户确认后执行：
npm run docs:build
向用户确认：
即将根据最新源码和文档更新
README.md，是否继续？
用户确认后，重新读取 src/index.ts、各模块源码文件以及更新后的 docs/ 文档，对 README.md 进行核查和修正：
若 README.md 内容极简（不足 20 行或缺少安装说明、基本使用示例），视为需要初始化，根据源码和 docs/ 文档生成完整的 README.md，内容应包含以下所有部分（严格按照源码，不得编造）：
docs/guide/introduction.md 提炼，说明这是什么、解决什么问题package.json）；以及 CDN 使用方式（取自 docs/guide/install.md）docs/guide/quick-start.md若 README.md 已有完整内容，则只修正与源码不符的方法名、参数类型、版本号、代码示例，保持文件原有结构和风格，不得编造任何内容。
完成后向用户汇报修改或生成了哪些内容，直接进入下一步。
向用户确认：
即将执行
npm publish将dap-util@{新版本号}发布到 npm，是否继续？
用户确认后，先尝试通过 Bash 工具执行：
npm publish
根据结果处理：
EOTP 或需要二次验证（OTP/浏览器认证）：告知用户 Bash 工具为非交互模式，无法完成认证流程，请用户在自己的终端中手动运行 npm publish，npm 会输出浏览器认证链接，完成认证后发布会自动继续。告知用户完成后继续步骤 8。所有步骤全部成功后，告知用户：
🎉 dap-util v{新版本号} 已发布完成！
本次完成的工作：
- ✅ 版本号已更新为 {新版本号}
- ✅ 源代码已打包（npm run lib）
- ✅ docs/ 文档已检查并更新
- ✅ changelog.md 已更新
- ✅ 文档已打包（npm run docs:build）
- ✅ README.md 已更新
- ✅ 已发布至 npm（npm publish）