Menu
dap-util 发布流程，按步骤完成版本号更新、源码打包、文档更新、changelog 更新、文档打包、README 更新、npm 发布，每步均需用户确认后执行。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| 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）