create-dwy 0.14.7 → 0.16.0

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish/SKILL.md

@@ -0,0 +1,365 @@
+---
+name: dwy-github-action-publish
+description: "GitHub Actions 打包分发避坑指南。先判断场景，再读取对应配置。场景 1：Python 含 C 扩展 / Cython / .so 的跨平台 wheel，用 cibuildwheel 构建并通过 PyPI Trusted Publisher(OIDC) 发布。场景 2：Electron 桌面应用多平台打包分发，用 electron-builder / electron-forge 在 macOS / Windows / Linux runner 上构建并发布 GitHub Release。覆盖 workflow YAML 解析、runner image 退役、matrix 拆分、跨平台 shell 引号、artifact/release、PyPI OIDC、Electron 签名/公证/Linux 依赖/产物命名等高频坑。触发条件：编辑或新建 .github/workflows/*.yml、用户说 GitHub Actions 打包 / 跨平台打包 / cibuildwheel / wheel build / Electron 打包 / electron-builder / electron-forge / GitHub Release 分发 / runner queued / workflow build 失败。也作为 dwy-publish 发版编排的 GA 打包子能力被主动调用。"
+---
+
+# dwy-github-action-publish — GitHub Actions 打包分发避坑
+
+定位：使用 GitHub Actions 做跨平台构建、打包、发布时，先判定产物类型，再查对应配置避坑。
+
+本 skill 只处理 CI 打包分发链路。通用发版流程（测试 / bump / changelog / tag）走 `dwy-publish`；SDK 发布前安全审计走 `dwy-sdk-spec`；纯 Python 包不需要 cibuildwheel。
+
+实战来源：
+
+- Python wheel：quant-sdk 0.4.0 首发 PyPI 的 cibuildwheel 踩坑。
+- Electron：某 Electron 桌面应用多平台打包（release.yml + build.yml + pack.mjs）实战配置。
+
+---
+
+## 先判断场景
+
+先读用户目标和仓库配置，不要直接套模板。
+
+| 场景 | 判断依据 | 必读配置 |
+|---|---|---|
+| Python wheel | `pyproject.toml` 含 `Cython` / `ext_modules` / `Extension` / 产物含 `.so` / 用户提 `cibuildwheel`、`wheel`、`PyPI` | `.github/workflows/*.yml`、`pyproject.toml`、`setup.py` / `setup.cfg`、`tests/` |
+| Electron 桌面应用 | `package.json` 含 `electron` + `electron-builder` / `electron-forge`，用户提 Electron 多平台打包、GitHub Release、`dmg` / `exe` / `AppImage` | `.github/workflows/*.yml`、`package.json`、`electron-builder` 配置、`forge.config.*`、打包脚本 |
+
+如果同时存在两个场景，拆成两个 workflow 或两个 job 组分别处理。不要把 Python wheel 的 PyPI OIDC 规则套到 Electron，也不要把 Electron 的签名/产物规则套到 Python wheel。
+
+---
+
+## 通用 GitHub Actions 检查
+
+改任何 workflow 后先做这些检查。
+
+```bash
+# 1. YAML 必须能本地解析
+python3 -c "import yaml; yaml.safe_load(open('.github/workflows/release.yml'))"
+
+# 2. 检查 workflow 触发条件
+gh workflow list
+gh run list --workflow=release.yml --limit=5
+
+# 3. run 几秒 fail 且 jobs 为空，多半是 YAML 解析失败
+gh run view <run-id> --json jobs,conclusion
+```
+
+通用坑：
+
+- GitHub Action 不一定有 `v<N>` major alias。改 `uses:` 前查对应仓库 tag。
+- `run` / `env` 值里含 `:`、`=:all:`、`http://`、`${{ }}` 组合时，优先整体加引号。
+- matrix 不要默认 `fail-fast: true`。跨平台打包应设 `fail-fast: false`，保留其他平台产物和日志。
+- 不要使用退役 runner：`macos-13` / `macos-12` / `macos-11` / `ubuntu-20.04` 等会排队或失败。先查 `actions/runner-images` 当前 supported labels。
+- 长时间卡 `Waiting for a runner to pick up this job...`，优先怀疑 runner label 已退役或额度/架构不可用。
+- 发布 GitHub Release 需要 `permissions: contents: write`。
+- PyPI Trusted Publisher 需要 `permissions: id-token: write`，并绑定 workflow 和 environment。
+- artifact 名称必须包含平台和架构，避免多个 matrix 上传时互相覆盖。
+
+---
+
+## 场景 1：Python Cython wheel + PyPI OIDC
+
+适用：含 Cython 编译扩展的 Python 包、跨平台 wheel 分发（linux x86_64/aarch64 + macOS x86_64/arm64 + Windows AMD64）、GitHub Actions + cibuildwheel + PyPI Trusted Publisher OIDC 发版。
+
+模板：复制 `./references/release-workflow-template.yml` 到目标项目 `.github/workflows/release.yml`，只改：
+
+1. `package-dir: <PACKAGE_DIR>`：实际 SDK 子目录；单包仓库填 `.` 或省略。
+2. `CIBW_BUILD`：按需调整 Python 版本枚举。
+
+### Python 必查配置
+
+```bash
+rg -n "Cython|ext_modules|Extension|cibuildwheel|pypa/gh-action-pypi-publish|license|version" pyproject.toml setup.py setup.cfg .github/workflows
+```
+
+检查点：
+
+- `[build-system].requires` 含 `setuptools>=77`、`packaging>=24.2`、`wheel`、`Cython>=3.0.10`。
+- `pypa/cibuildwheel` 用 minor tag 或精确 tag，例如 `pypa/cibuildwheel@v3.4`，不要写 `@v3`。
+- monorepo 用 `with.package-dir`，测试命令使用 `{package}`，不要用 `{project}/tests`。
+- 跨平台 shell 参数用外单内双：`'pytest {package}/tests -v -k "not requires_server"'`。
+- Linux 依赖 pyarrow / pandas / numpy / scipy / lxml 时，manylinux 镜像用 `manylinux_2_28`。
+- test 阶段大依赖用 binary-only 预装：`CIBW_BEFORE_TEST: "pip install --only-binary=:all: pyarrow pandas"`。
+- macOS x86_64 用 `macos-15-intel`，不要用 `macos-13`。
+- 默认只发布 wheel。不要发布 sdist，避免 Cython 编译模块源码随 sdist 泄漏。
+
+### Python 8 个高频坑
+
+#### 坑 1：PEP 639 license expression 触发 build env 依赖冲突
+
+症状：
+
+```text
+ImportError: Cannot import `packaging.licenses`.
+Setuptools>=77.0.0 requires "packaging>=24.2" to work properly.
+```
+
+根因：`pyproject.toml` 用 `license = "MIT"` 时，setuptools 77+ 校验 license expression 依赖 `packaging>=24.2`，cibuildwheel 临时 build env 可能装到旧 packaging。
+
+修复：
+
+```toml
+[build-system]
+requires = [
+    "setuptools>=77",
+    "packaging>=24.2",
+    "wheel",
+    "Cython>=3.0.10",
+]
+build-backend = "setuptools.build_meta"
+```
+
+#### 坑 2：cibuildwheel action 必须用 minor 级或精确 tag
+
+症状：
+
+```text
+Unable to resolve action `pypa/cibuildwheel@v3`, unable to find version `v3`
+```
+
+修复：
+
+```yaml
+- uses: pypa/cibuildwheel@v3.4
+# 或
+- uses: pypa/cibuildwheel@v3.4.1
+```
+
+#### 坑 3：YAML 字符串含冒号必须加引号
+
+错误：
+
+```yaml
+CIBW_BEFORE_TEST: pip install --only-binary=:all: pyarrow
+```
+
+正确：
+
+```yaml
+CIBW_BEFORE_TEST: "pip install --only-binary=:all: pyarrow pandas"
+```
+
+#### 坑 4：CIBW_TEST_COMMAND 用 `{package}` 不要用 `{project}`
+
+```yaml
+- uses: pypa/cibuildwheel@v3.4
+  with:
+    package-dir: quant-sdk
+  env:
+    CIBW_TEST_COMMAND: 'pytest {package}/tests -v -k "not requires_server"'
+```
+
+#### 坑 5：跨平台 shell 引号必须外单内双
+
+错误：
+
+```yaml
+CIBW_TEST_COMMAND: "pytest {package}/tests -v -k 'not requires_server'"
+```
+
+正确：
+
+```yaml
+CIBW_TEST_COMMAND: 'pytest {package}/tests -v -k "not requires_server"'
+```
+
+#### 坑 6：manylinux 镜像必须升到 `_2_28`
+
+```yaml
+env:
+  CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+  CIBW_MANYLINUX_AARCH64_IMAGE: manylinux_2_28
+```
+
+#### 坑 7：测试阶段三方依赖必须强制 binary
+
+```yaml
+env:
+  CIBW_TEST_REQUIRES: pytest pytest-asyncio respx
+  CIBW_BEFORE_TEST: "pip install --only-binary=:all: pyarrow pandas"
+  CIBW_TEST_COMMAND: 'pytest {package}/tests -v -k "not requires_server"'
+```
+
+#### 坑 8：macos-13 runner 已退休
+
+```yaml
+matrix:
+  include:
+    - { os: ubuntu-latest,    archs: x86_64 }
+    - { os: ubuntu-24.04-arm, archs: aarch64 }
+    - { os: macos-15-intel,   archs: x86_64 }
+    - { os: macos-14,         archs: arm64 }
+    - { os: windows-latest,   archs: AMD64 }
+```
+
+---
+
+## 场景 2：Electron 多平台打包 + GitHub Release
+
+适用：Electron 桌面应用需要在 GitHub Actions 产出 macOS / Windows / Linux 安装包，并上传到 GitHub Release。
+
+参考配置：
+
+- `./references/electron-release-workflow-template.yml`
+
+### Electron 必查配置
+
+```bash
+rg -n "electron|electron-builder|electron-forge|pack|dist|dmg|AppImage|nsis|appx|CSC|notar|publish|artifactName|extraResources|asar|submodules" package.json .github/workflows script src -g '!node_modules'
+```
+
+检查点：
+
+- `package.json` 明确 `electron` 和打包工具版本，例如 `electron-builder`。
+- workflow 用 `actions/checkout@v4`，项目依赖 submodule 时必须 `submodules: true`。
+- Node 版本固定，例如 `actions/setup-node@v4` + `node-version: 20`。
+- 使用锁文件安装：npm 项目用 `npm ci`，pnpm 项目用 `pnpm install --frozen-lockfile`。
+- 每个平台在对应 runner 上打包，不要指望一个 Linux runner 交叉产出 macOS / Windows 完整安装包。
+- macOS x64 和 arm64 分开：x64 用 `macos-15-intel`，arm64 用 `macos-latest` / `macos-14`。
+- Linux AppImage 需要系统依赖，常见为 `icnsutils graphicsmagick xz-utils`。
+- Linux runner 上 `apt-get update` 前可移除易失效的 Microsoft / Azure apt source，避免第三方源拖死打包。
+- 未配置证书但要产出 unsigned 包时，设置 `CSC_IDENTITY_AUTO_DISCOVERY: false`，避免 electron-builder 自动找证书导致 macOS job 失败。
+- 产物命名必须包含 `${version}`、`${os}`、`${arch}`，避免 Release asset 覆盖。
+- upload-artifact 只上传最终安装包：`*.dmg`、`*.exe`、`*.AppImage`；不要上传 `win-unpacked/`。
+- GitHub Release job 需要 `permissions: contents: write`，用 `actions/download-artifact@v4` + `merge-multiple: true` 汇总产物。
+
+### Electron 推荐 workflow 形态
+
+模板：复制 `./references/electron-release-workflow-template.yml` 到目标项目 `.github/workflows/release.yml`，再按项目实际包管理器、打包脚本、签名策略调整。完整 workflow 见该模板，下方高频坑解释各关键配置的原因。
+
+### Electron 多平台高频坑
+
+#### 坑 1：macOS x64 / arm64 不能混跑
+
+macOS x64 用 `macos-15-intel`。macOS arm64 用 `macos-latest` / `macos-14`。不要用已退役的 `macos-13`。
+
+#### 坑 2：Linux 打 AppImage 缺系统依赖
+
+症状通常是图标转换、压缩、AppImage 生成失败。
+
+```yaml
+sudo apt-get install --no-install-recommends -y icnsutils graphicsmagick xz-utils
+```
+
+#### 坑 3：Ubuntu 第三方 apt 源拖死 `apt-get update`
+
+GitHub hosted runner 预置源会变化。第三方源异常时，先移除无关 source。
+
+```yaml
+sudo rm -f /etc/apt/sources.list.d/azure-cli.list /etc/apt/sources.list.d/microsoft-prod.list
+sudo apt-get update
+```
+
+#### 坑 4：未签名构建被 electron-builder 自动证书探测拖死
+
+公开 unsigned 包或暂未配置证书时：
+
+```yaml
+env:
+  CSC_IDENTITY_AUTO_DISCOVERY: false
+```
+
+如果需要签名/公证，显式配置 secrets：`CSC_LINK`、`CSC_KEY_PASSWORD`、`APPLE_ID`、`APPLE_APP_SPECIFIC_PASSWORD`、`APPLE_TEAM_ID`。不要同时依赖自动探测。
+
+#### 坑 5：产物名不含平台架构导致 Release 覆盖
+
+electron-builder 配置应使用稳定命名：
+
+```js
+artifactName: '${productName}-${version}-${os}-${arch}.${ext}'
+```
+
+#### 坑 6：只上传最终安装包
+
+推荐：
+
+```yaml
+path: |
+  release/**/*.dmg
+  release/**/*.exe
+  release/**/*.AppImage
+```
+
+需要自动更新时再上传 `*-latest.yml`。不要上传 `win-unpacked/`。
+
+#### 坑 7：外部二进制资源必须在打包前下载
+
+如果应用依赖 ADB、scrcpy server、native helper、Java/Android 构建产物，必须在 `npm run pack` 前完成下载或构建，并确保路径进入 `extraResources` / `files`。
+
+#### 坑 8：Release job 必须先汇总 artifact 再发布
+
+```yaml
+- uses: actions/download-artifact@v4
+  with:
+    path: artifacts
+    merge-multiple: true
+```
+
+发布前用 `find artifacts -type f` 打印文件列表，确认平台产物齐全。
+
+---
+
+## 安全重发流程
+
+### Python PyPI
+
+前提：PyPI 上还没有 publish 成功该版本号。PyPI 版本号一旦发布成功，永久不可复用，必须 bump 下一个版本。
+
+```bash
+gh run cancel <run-id>
+git add <修改文件>
+git commit -m "ci(sdk): 修复 xxx"
+git push origin main
+git push origin :refs/tags/v0.4.0
+git tag -d v0.4.0
+git tag v0.4.0
+git push origin v0.4.0
+gh run watch "$(gh run list --workflow=release.yml --limit=1 --json databaseId --jq '.[0].databaseId')" --exit-status
+```
+
+### Electron GitHub Release
+
+如果 GitHub Release 已创建但产物错误，优先删错 release / tag 后重打，或 bump 版本。不要在同 tag 上混入不同 commit 的产物。
+
+```bash
+gh release view v1.2.3
+gh release delete v1.2.3 --cleanup-tag
+git tag v1.2.3
+git push origin v1.2.3
+```
+
+执行删除前必须确认用户允许，因为这会删除远端 release / tag。
+
+---
+
+## 不要做
+
+- 不要在本地跑 `python -m build && twine upload` 替代跨平台 wheel 发布。
+- 不要给 Cython 包发布 sdist，除非明确接受源码泄漏。
+- 不要假设 GitHub Action 有 major moving tag。
+- 不要跳过 workflow YAML 本地解析。
+- 不要用退役 runner label。
+- 不要让多个 matrix 上传同名 artifact。
+- 不要在 Electron 未配置签名时依赖证书自动探测。
+- 不要把 `win-unpacked/`、中间目录、缓存目录发进 Release。
+- 不要在一个 runner 上硬交叉构建所有 Electron 平台。
+
+---
+
+## 违规检测清单
+
+| 检查项 | 违规模式 | 严重程度 |
+|---|---|---|
+| YAML 解析 | env / run 含 `:` 未加引号，run 几秒 fail 且 jobs 为空 | 致命 |
+| action tag | `pypa/cibuildwheel@v3` 等不存在 alias | 致命 |
+| runner | `macos-13` / `macos-12` / `ubuntu-20.04` | 致命 |
+| artifact | matrix 上传同名产物或未带平台架构 | 高 |
+| Python build-system | PEP 639 license 但缺 `packaging>=24.2` | 致命 |
+| Python test path | monorepo 子目录用 `{project}/tests` | 高 |
+| Python shell 引号 | Windows 跨平台命令里用单引号包参数 | 高 |
+| Python manylinux | 大型 C 库依赖仍用 manylinux2014 | 高 |
+| Electron macOS | x64 / arm64 未拆 runner | 高 |
+| Electron Linux | AppImage 缺 `icnsutils graphicsmagick xz-utils` | 高 |
+| Electron 签名 | unsigned 构建未设 `CSC_IDENTITY_AUTO_DISCOVERY: false` | 中 |
+| Electron Release | 上传 unpacked 中间目录或漏最终安装包 | 高 |

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish/references/electron-release-workflow-template.yml

@@ -0,0 +1,98 @@
+# Electron 多平台打包 + GitHub Release workflow 模板
+#
+# 来源参考: 某 Electron 桌面应用多平台打包实战 (release.yml + pack.mjs)
+#
+# 使用前按项目实际情况替换:
+#   1. node-version
+#   2. 包管理器安装命令(npm ci / pnpm install --frozen-lockfile)
+#   3. build / pack 命令
+#   4. Linux 系统依赖
+#   5. 签名 / 公证 secrets
+#   6. artifact path 和文件命名
+
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-15-intel
+            platform: mac-x64
+            packArgs: ""
+          - os: macos-latest
+            platform: mac-arm64
+            packArgs: "-- --arm64"
+          - os: windows-latest
+            platform: win
+            packArgs: ""
+          - os: ubuntu-latest
+            platform: linux
+            packArgs: "-- --linux"
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install Linux packaging dependencies
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo rm -f /etc/apt/sources.list.d/azure-cli.list /etc/apt/sources.list.d/microsoft-prod.list
+          sudo apt-get update
+          sudo apt-get install --no-install-recommends -y icnsutils graphicsmagick xz-utils
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Package
+        run: npm run pack ${{ matrix.packArgs }}
+        env:
+          CSC_IDENTITY_AUTO_DISCOVERY: false
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-${{ matrix.platform }}
+          path: |
+            release/**/*.dmg
+            release/**/*.exe
+            release/**/*.AppImage
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: List release files
+        run: find artifacts -type f
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/**/*
+          generate_release_notes: true
+          draft: false

package/templates/ai-tools/skills//{350/277/220/347/273/264/345/217/221/345/270/203/dwy-cibuildwheel → 345/217/221/345/270/203/345/217/221/347/211/210/dwy-github-action-publish}/references/release-workflow-template.yml

@@ -1,6 +1,6 @@
 # Python Cython SDK 跨平台 wheel + PyPI Trusted Publisher 发版 workflow 模板
 #
-# 已内置 dwy-cibuildwheel skill 7 个避坑修复，开箱即用。
+# 已内置 dwy-github-action-publish skill Python wheel 场景 8 个避坑修复，开箱即用。
 # 复制到项目 .github/workflows/release.yml，只改两处：
 #   1. package-dir: <PACKAGE_DIR>      —— 实际 SDK 子目录（monorepo 必填，单包仓库填 . 或省略）
 #   2. CIBW_BUILD                      —— 按需调整 Python 版本枚举
@@ -42,7 +42,7 @@ jobs:
         include:
           - { os: ubuntu-latest,    archs: x86_64 }
           - { os: ubuntu-24.04-arm, archs: aarch64 }
-          # 坑 8: macos-13 已于 2025-12-04 退休,用 macos-15-intel(真 Intel runner)替代
+          # 坑 8: macos-13 已退休,用 macos-15-intel(真 Intel runner)替代
           # 如果不需要 x86_64 wheel,删掉下一行,Intel Mac 用户走 Rosetta 跑 arm64 wheel
           - { os: macos-15-intel,   archs: x86_64 }
           - { os: macos-14,         archs: arm64 }
@@ -66,7 +66,7 @@ jobs:
           CIBW_MUSLLINUX_X86_64_IMAGE: musllinux_1_2
           CIBW_MUSLLINUX_AARCH64_IMAGE: musllinux_1_2
           CIBW_TEST_REQUIRES: pytest pytest-asyncio respx
-          # 坑 3 + 坑 7: 整行加双引号避免 YAML 冒号歧义；强制 binary 防止源码 build 链
+          # 坑 3 + 坑 7: 整行加双引号避免 YAML 冒号歧义; 强制 binary 防止源码 build 链
           CIBW_BEFORE_TEST: "pip install --only-binary=:all: pyarrow pandas"
           # 坑 4 + 坑 5: monorepo 用 {package} 而非 {project}；外单内双跨平台兼容
           CIBW_TEST_COMMAND: 'pytest {package}/tests -v -k "not requires_server"'

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: dwy-publish
+description: "发版/部署编排器。触发条件：用户说\"发版\"\"部署\"\"发布上线\"\"release\"\"publish\"\"走发版流程\"时。按应用目录确认发布方式并缓存，串起定版本→changelog→安全检查→build/发布→监控→通知。版本号决策单独走 dwy-semver，GA 打包走 dwy-github-action-publish，发布前安全检查走 dwy-sdk-spec——本 skill 负责编排，按路径主动调它们。"
+---
+
+# 发版编排器
+
+一条发版链的编排执行。进入前测试已完成。
+
+**先**读仓库上下文，判目标平台（前端/后端/Android/iOS/鸿蒙/通用）+ 定位应用目录（相对项目根的相对路径）。**再**按下表执行 8 步。
+
+| # | 步骤 | 类型 | 调用 |
+|---|------|------|------|
+| 1 | 确认发布方式 + 探测 build/publish 命令 | 项目步 | `scripts/release_config.sh` + `references/publish-config.md` |
+| 2 | 写/校验发布配置（GA workflow / TestFlight 就绪） | 项目步 | `references/publish-config.md` |
+| 3 | 定版本号 + 多文件同步 | 通用步 | `../dwy-semver` + `references/version-sync.md` |
+| 4 | 写 changelog（按平台子目录） | 通用步 | `references/changelog.md` |
+| 5 | 安全检查（闸门，未过不发） | 通用步 | `../dwy-sdk-spec` |
+| 6 | build + 触发发布 | 项目步 | `references/<平台>.md`；走 GA 引 `../dwy-github-action-publish` |
+| 7 | 监控发布进程 | 项目步 | `references/monitor-notify.md` |
+| 8 | 通知结果（输出结果文本） | — | `references/monitor-notify.md` |
+
+平台流程文件：`frontend-deploy.md` / `backend-deploy.md` / `ios.md` / `android.md` / `harmony.md` / `generic-release.md`。
+
+## 编排约束
+
+- **通用步固化**（定版本/changelog/安全检查跨项目一致，走子 skill/脚本）；**项目步读上下文+缓存**（build/deploy/监控命令因项目而异，**绝不写死**，探测不到问用户后缓存）。
+- 安全检查（第 5 步）是闸门，未过不进发布。
+- 全程 AI 自动判断、自动跑，仅搞不定时才问用户（版本级别拿不准、命令探测不到、配置缺失、构建/发布失败）。
+- 编排时按文件路径主动加载子 skill（`../dwy-semver`、`../dwy-sdk-spec`、`../dwy-github-action-publish`）；这些 skill 也可被用户独立触发。
+- `.dwy/` 缓存提醒用户加进 `.gitignore`。

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/android.md

@@ -0,0 +1,31 @@
+# Android 发布流程
+
+适用：Android 产物——**应用包（apk/aab→分发/商店）** 或 **SDK（aar→maven）**。
+
+## 先判产物形态
+
+- 应用包：有 application module、产出 apk/aab → 走 app 路径
+- SDK：library module、产出 aar、有 maven publish 配置 → 走 SDK 路径
+
+## 版本（通用步，固化）
+
+- `versionName` = 语义版本号，走 `../dwy-semver` 决策 + bump.py。
+- `versionCode` = 单调递增整数，每次发布 +1。
+- 多文件同步见 `version-sync.md`。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`build.gradle(.kts)` task、`gradlew`、`fastlane/`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `maven` → 用项目实际的 maven 发布命令（gradle publish task / 私有源）
+- `github-action` → 引 `../dwy-github-action-publish`（先过通用检查）
+- `local` → 缓存的本地构建/发布命令
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（写 `android/CHANGELOG.md`）
+- 安全检查 → `../dwy-sdk-spec`
+- 监控 + 结果 → `monitor-notify.md`

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/backend-deploy.md

@@ -0,0 +1,23 @@
+# 后端部署流程
+
+适用：后端服务、API、容器或镜像、线上后端环境。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（Python 须同步 `pyproject.toml` 的 `version` 和包 `__init__.py` 的 `__version__`）。
+- 纯重发、仅重跑 workflow、仅补环境配置、仅回滚已有构建时可不 bump。
+
+## build / deploy（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`Dockerfile`、`docker-compose`、部署脚本、`Makefile`、`pyproject.toml`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action` → 引 `../dwy-github-action-publish`（CI 推荐 OIDC，先过通用检查）
+- `local` → 缓存的本地构建/部署命令（打镜像 / 部署脚本）
+
+## changelog / 监控
+
+- changelog → `changelog.md`（写 `backend/CHANGELOG.md`）
+- 监控 + verify → `monitor-notify.md`（后端信号：健康检查 / 版本接口 / 运行日志 / 镜像 tag）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/changelog.md

@@ -0,0 +1,37 @@
+# CHANGELOG 按平台子目录各写一份
+
+monorepo 下一个仓库可能同时含 android / ios / harmony / frontend / backend 多平台。**每个平台维护自己的 CHANGELOG，不写全局单份**。发哪个平台，只写哪个平台那份。
+
+## 各平台 CHANGELOG 位置
+
+- `android/CHANGELOG.md`
+- `ios/CHANGELOG.md`
+- `harmony/CHANGELOG.md`
+- `frontend/CHANGELOG.md`
+- `backend/CHANGELOG.md`
+
+子目录名按仓库实际结构定（先在第 0 步识别平台目录）。
+
+## 写法
+
+1. 找该平台上一个 release tag
+2. 按平台子目录过滤 commit：
+
+```bash
+git log <last-tag>..HEAD --oneline -- <平台子目录>/
+```
+
+3. 按 `feat` / `fix` / `refactor` / `chore` 分组
+4. 写入该平台 `CHANGELOG.md`，标注新版本号
+
+如果仓库已有自动生成命令（changelogen 等），优先使用，但仍按平台目录过滤范围。
+
+## 自动执行
+
+changelog 由 AI 自动生成并写入，不强制逐步确认。仅当 commit 历史无法清晰归类、或平台目录边界不明时才停下问用户。
+
+## 禁止
+
+- 禁止写一份全局 CHANGELOG 混入多平台变更
+- 禁止 changelog 未写完就进入部署
+- 禁止把其他平台的 commit 写进当前平台 CHANGELOG（必须按目录过滤）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/frontend-deploy.md

@@ -0,0 +1,23 @@
+# 前端部署流程
+
+适用：站点、SPA、SSR、前端容器镜像或线上前端环境。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（前端改 `package.json` 的 `version`）。
+- 纯重发、仅重跑 workflow、仅回滚已有构建时可不 bump。
+
+## build / deploy（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`package.json` scripts（build/deploy）、`vite.config.*`、`Dockerfile`、`Makefile`、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action` → 引 `../dwy-github-action-publish`（CI 推荐 OIDC，先过通用检查）
+- `local` → 缓存的本地构建/部署命令（推镜像 / 传 CDN·OSS / 部署脚本）
+
+## changelog / 监控
+
+- changelog → `changelog.md`（写 `frontend/CHANGELOG.md`）
+- 监控 + verify → `monitor-notify.md`（前端信号：页面访问 / 版本接口 / 产物 hash / CDN 刷新）

package/templates/ai-tools/skills//345/217/221/345/270/203/345/217/221/347/211/210/dwy-publish/references/generic-release.md

@@ -0,0 +1,27 @@
+# 通用发布流程（兜底）
+
+适用：不属于前端 / 后端 / Android / iOS / 鸿蒙 五类的发布——CLI 二进制、Docker 镜像、纯 PyPI / npm 库、其他对外包或环境。dwy-shared 自身的 eui / ekit / eapi / cli 走这条。
+
+## 版本（通用步，固化）
+
+- 走 `../dwy-semver` 决策 + bump.py；多文件同步见 `version-sync.md`（Python 同步 `pyproject.toml` + `__init__.py`，Node 同步 `package.json`）。
+- 纯重发、仅重跑 workflow、仅回滚已有构建时可不 bump。
+
+## build / publish（项目步，不写死命令）
+
+命令来自缓存（build_cmd/publish_cmd），缓存缺则按 `publish-config.md` 探测：
+- 探测线索：`package.json` scripts、`pyproject.toml`、`Makefile`、发布脚本、CI workflow
+- 探测不到→问用户→缓存
+
+按缓存 method 分流：
+- `github-action-oidc` → **PyPI/npm 首选**，引 `../dwy-github-action-publish`（OIDC + Trusted Publisher）
+- `github-action` → Cython wheel / Electron / 镜像，引 `../dwy-github-action-publish`
+- `local` → 缓存的本地发包命令（`uv publish` / `pnpm publish` 等）
+
+**PyPI/npm 未配置 GA 时按 `publish-config.md` 主动推荐 OIDC。**
+
+## changelog / 安全检查 / 监控
+
+- changelog → `changelog.md`（单包仓库根目录一份；monorepo 按包目录过滤）
+- 安全检查 → `../dwy-sdk-spec`（对外包必查泄露/产物）
+- 监控 + verify → `monitor-notify.md`（包仓库版本查询 / GitHub Release）