@zhouhao4221/devflow-skills 0.2.0

package/LICENSE

@@ -0,0 +1,191 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Haiqing
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,289 @@
+# DevFlow Skills
+
+DevFlow 插件技能集合 —— 独立技能包，包含 [DevFlow](https://github.com/zhouhao4221/devflow-claude) 所有插件的 AI 执行指令（SKILL.md）。支持 OpenCode、Claude Code、Codex 三大 AI 工具。
+
+## 快速开始
+
+使用 CLI 工具一键安装技能到目标 AI 工具目录：
+
+```bash
+# 安装全部技能到 OpenCode
+npx devflow-skills install --tool opencode --all
+
+# 安装指定技能
+npx devflow-skills install --tool opencode --skill req-dev --skill req-review
+
+# 列出所有可用技能
+npx devflow-skills list
+
+# 卸载技能
+npx devflow-skills uninstall --tool opencode --all
+```
+
+首次运行 `npx` 时会自动下载对应平台 Go 二进制，也可通过 Go install 安装：
+
+```bash
+go install github.com/zhouhao4221/devflow-skills@latest
+devflow-skills install --tool claude --all
+```
+
+## 概述
+
+本仓库从 [devflow-claude](https://github.com/zhouhao4221/devflow-claude) 主仓库中提取所有 SKILL.md 文件，作为独立的技能包提供给 CI 校验、版本管理和跨工具分发。每个 SKILL.md 文件定义了 AI 工具在执行对应命令时的行为指引。
+
+### CLI 命令速览
+
+| 命令 | 说明 |
+|------|------|
+| `install` | 安装技能到目标 AI 工具目录 |
+| `list` | 列出所有可用技能，支持按插件过滤和 JSON 输出 |
+| `uninstall` | 从目标 AI 工具目录卸载技能 |
+
+| 参数 | 说明 |
+|------|------|
+| `--tool opencode\|claude\|codex` | 目标 AI 工具（必填） |
+| `--skill <NAME>` | 要操作的技能名，支持重复指定多个 |
+| `--all` | 操作所有技能（与 `--skill` 互斥） |
+| `--dir <PATH>` | 目标项目根目录（默认 `.`） |
+| `--plugin <NAME>` | 按插件过滤（`list` 命令） |
+| `--format text\|json` | 输出格式（`list` 命令） |
+
+### CLI 安装示例
+
+```bash
+# OpenCode: 安装到 .agents/skills/（扁平命名，如 req-dev）
+npx devflow-skills install --tool opencode --skill req-dev
+
+# Claude Code: 安装到 plugins/req/skills/dev/（分层目录）
+npx devflow-skills install --tool claude --all
+
+# Codex: 安装到 .agents/skills/（扁平命名，同上）
+npx devflow-skills install --tool codex --all
+
+# 指定目标目录
+npx devflow-skills install --tool opencode --all --dir ../my-project
+```
+
+## 仓库结构
+
+```
+plugins/
+├── req/skills/     # 需求管理技能（46 个）
+├── api/skills/     # API 对接技能（8 个）
+├── pm/skills/      # 项目管理技能（14 个）
+├── diag/skills/    # 生产诊断技能（5 个）
+└── uat/skills/     # 验收测试技能（7 个）
+skill-bindings.json  # 命令-技能映射关系
+```
+
+## 技能分类
+
+### req — 需求全流程管理
+覆盖从需求分析、评审、开发、测试到归档的完整生命周期，包括智能开发（`dev`）、规范提交（`commit`）、版本发布（`release`）、代码审查（`review-pr`）、自然语言调度（`natural-language-dispatcher`）等 46 个技能。
+
+**自动触发技能**：
+| 技能 | 触发场景 |
+|------|---------|
+| `requirement-analyzer` | 创建/编辑需求时自动分析 |
+| `dev-guide` | 开发阶段按分层架构引导 |
+| `quick-fix-guide` | 快速修复时引导 |
+| `test-guide` | 测试阶段引导回归和新建 |
+| `prd-analyzer` | PRD 编辑时辅助完善 |
+| `code-impact-analyzer` | 需求变更时分析代码影响 |
+| `changelog-generator` | 自动生成版本变更说明 |
+| `version-bumper` | 发版时自动推导版本号 |
+
+### api — API 对接
+支持 Swagger/OpenAPI 解析、字段映射、代码生成、接口搜索等 8 个技能。
+
+### pm — 项目管理助手
+从 PRD、需求文档和 Git 记录中提取数据，生成汇报、统计、方案等 14 个技能。
+
+### diag — 生产诊断
+只读诊断 + 修复建议，包含审计、堆栈分析等 5 个技能，含安全风控 Hook。
+
+### uat — 用户验收测试
+UI 验收测试工作流，含测试执行器、报告生成等 7 个技能。
+
+## skill-bindings.json
+
+`skill-bindings.json` 声明了命令与技能之间的映射关系：
+
+```json
+{
+  "plugins": {
+    "req": {
+      "commands": {
+        "dev": {
+          "primarySkill": "dev",
+          "additionalSkills": ["dev-guide"]
+        }
+      }
+    }
+  },
+  "allSkills": {
+    "req": ["dev", "dev-guide", ...]
+  }
+}
+```
+
+- `commands.<name>.primarySkill`: 命令直接对应的技能
+- `commands.<name>.additionalSkills`: 命令执行过程中自动触发的辅助技能
+- `allSkills`: 各插件拥有的全部技能清单
+
+CI 会验证：
+1. `allSkills` 中声明的技能都有对应的 `SKILL.md` 文件
+2. 实际存在的 `SKILL.md` 文件都在 `allSkills` 中有声明
+3. 命令中引用的技能名都在 `allSkills` 中存在
+
+## CI 校验
+
+每次 push 或 PR 时自动运行 CI（`.github/workflows/ci.yml`），包含：
+
+| 检查项 | 说明 |
+|--------|------|
+| validate-source | 全量校验 80 个 SKILL.md 是否符合 agentskills.io 规范（name 正则、description 长度） |
+| validate-claude | setup-claude 脚本输出完整性检查 |
+| validate-opencode | setup-opencode 输出 frontmatter 格式 + 计数 |
+| validate-codex | setup-codex + openai.yaml 输出完整性 |
+
+本地手动运行：`./scripts/validate-skills.sh --ci`
+
+---
+
+## 手动安装（适配器脚本）
+
+CLI 工具（上节）已覆盖所有常见场景。如需在不同环境分配不同路径、或嵌入 CI 流程，可通过适配器脚本手动生成。
+
+devflow-skills 作为唯一起源，通过适配器脚本生成各工具兼容的技能目录。以下分别说明 Claude Code、OpenCode、Codex 三工具的安装方式。
+
+### 前置条件
+
+- 已 clone 本仓库
+- Python 3 可用（用于 `_get-description.py`）
+
+### Claude Code
+
+Claude Code 通过插件 marketplace 加载技能，使用分层目录结构（`plugins/<plugin>/skills/<name>/SKILL.md`）。
+
+```bash
+# 同步技能到 devflow-claude 仓库
+./scripts/setup-claude.sh . ../devflow-claude
+# 参数: <devflow-skills路径> [devflow-claude路径]
+```
+
+产物路径：`../devflow-claude/plugins/<plugin>/skills/<name>/SKILL.md`（80 个文件，与源结构一致）。由 devflow-claude 的 `plugin.json` 加载。
+
+### OpenCode
+
+OpenCode 从 `.agents/skills/` 发现技能，使用扁平化命名（`<plugin>-<name>`）。
+
+```bash
+# 生成 OpenCode 兼容的技能目录
+./scripts/setup-opencode.sh . ~/.agents/skills
+# 参数: <devflow-skills路径> [输出路径，默认 .agents/skills/]
+```
+
+产物路径：`~/.agents/skills/<plugin>-<name>/SKILL.md`（80 个目录，name 已自动更新为扁平化前缀）。OpenCode 启动时自动发现所有技能。
+
+### Codex
+
+Codex 同样从 `.agents/skills/` 发现技能，兼容 agentskills.io 规范。
+
+```bash
+# 基础安装（仅技能目录）
+./scripts/setup-codex.sh . ~/.agents/skills
+
+# 附加生成 UI 元数据清单（agents/openai.yaml）
+./scripts/setup-codex.sh . ~/.agents/skills --gen-openai-yaml
+```
+
+产物路径：`~/.agents/skills/<plugin>-<name>/SKILL.md`（80 个目录）。`--gen-openai-yaml` 额外生成 `agents/openai.yaml`，提供 display_name、description 等 UI 元数据。
+
+### 验证安装
+
+安装完成后运行校验脚本确认一切正常：
+
+```bash
+./scripts/validate-skills.sh --ci
+```
+
+通过后输出 `SUCCESS: all validations passed`，共 8 项检查全部 PASS。
+
+---
+
+## 设计理念
+
+### 为什么做跨工具 Skill 通用化
+
+当前 80 个 SKILL.md 以 Claude Code marketplace 为原生格式（`plugins/<plugin>/skills/<name>/SKILL.md`），在 Codex、OpenCode 等工具中无法直接加载。各工具的 skill 发现机制不同：
+
+| 工具 | 发现路径 | 命名方式 |
+|------|---------|----------|
+| Claude Code | `plugins/<plugin>/skills/<name>/SKILL.md` | 插件层作用域 |
+| OpenCode | `.agents/skills/<name>/SKILL.md` | 全局扁平 |
+| Codex | `.agents/skills/<name>/SKILL.md` | 全局扁平 |
+
+**核心思路**：devflow-skills 作为唯一起源（single source of truth），不修改 80 个 SKILL.md 正文内容，通过适配层脚本（adapter scripts）为各工具生成各自的兼容产物。
+
+### 关键设计决策
+
+#### D1：统一标准 — 采用 agentskills.io 规范
+
+[agentskills.io](https://agentskills.io/specification) 是 Open Agent Skills Standard，Codex 原生内置、OpenCode 兼容支持。格式要求为 YAML frontmatter（`name` + `description` 必填）+ Markdown 正文。当前 80 个 SKILL.md 全部使用此格式，零修改即兼容核心要求。
+
+选择理由：
+- 已被业界采纳（Codex 原生、OpenCode 兼容），非私有标准
+- 格式简洁（两个必填字段 + 可选扩展），与现有 SKILL.md 完全兼容
+- 有明确的命名正则约束（`^[a-z0-9]+(-[a-z0-9]+)*$`），保证跨工具一致性
+
+#### D2：命名策略 — `<plugin>-<name>` 扁平化
+
+Claude Code 按插件分层（`req/dev`、`api/search`），名字无需全局唯一。但 OpenCode/Codex 是全局扁平名字空间。采用 `<plugin>-<name>` 前缀方案（如 `req-dev`、`api-search`）：
+
+- **全局唯一**：多个插件下的重名技能（如 `help`、`init`、`new`）加上前缀后自然去重（`req-help` vs `api-help` vs `pm-help`）
+- **可读性强**：一眼可知技能所属插件
+- **符合 agentskills.io 正则**：全部由小写字母、数字、连字符组成
+
+命名变更在适配层处理（复制时通过 `sed` 更新 frontmatter `name` 字段），源头 SKILL.md 正文不动。
+
+#### D3：适配路径 — `.agents/skills/` 作为三工具最大公约数
+
+OpenCode 和 Codex 均原生扫描 `.agents/skills/`，且 OpenCode 也兼容 `.claude/skills/`。选择 `.agents/skills/` 作为适配器统一输出路径，确保：
+- OpenCode 和 Codex 零配置可用
+- Claude Code 仍通过 `plugins/*/skills/` 加载（setup-claude.sh 直接 copy，不使用 `.agents/skills/`）
+
+#### D4：不修改源头 SKILL.md
+
+80 个 SKILL.md 始终保持原样，所有跨工具适配（name 扁平化、路径重组）都在适配器脚本的复制过程中完成。好处：
+- 源头文件干净、可独立维护
+- 各工具适配逻辑独立，互不干扰
+- CI 校验只需对源头文件生效
+
+### 架构总览
+
+```
+                         ┌────────────────────┐
+                         │   devflow-skills    │  ← 唯一起源
+                         │  plugins/<plugin>/  │     80 个 SKILL.md
+                         │  skills/<name>/     │     零修改
+                         │  SKILL.md           │
+                         │  skill-bindings.json│
+                         └────────┬───────────┘
+                                  │
+                    ┌─────────────┼─────────────┐
+                    ▼             ▼             ▼
+           ┌───────────┐  ┌───────────┐  ┌───────────┐
+           │  Claude   │  │ OpenCode  │  │   Codex   │
+           │  Adapter  │  │  Adapter  │  │  Adapter  │
+           └─────┬─────┘  └─────┬─────┘  └─────┬─────┘
+                 ▼              ▼              ▼
+        plugins/*/skills/  .agents/skills/  .agents/skills/
+        (分层插件结构)      (扁平前缀命名)    (扁平前缀命名)
+```
+
+---
+
+## 许可证
+
+[Apache License 2.0](LICENSE)

package/install.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+
+const { spawnSync, execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+
+const VERSION = require('./package.json').version;
+const BINARY_NAME = process.platform === 'win32' ? 'devflow-skills.exe' : 'devflow-skills';
+
+function getPlatform() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const archMap = { x64: 'amd64', arm64: 'arm64', ia32: '386' };
+  const mappedArch = archMap[arch] || arch;
+
+  let platformName;
+  switch (platform) {
+    case 'linux':
+      platformName = 'linux';
+      break;
+    case 'darwin':
+      platformName = 'darwin';
+      break;
+    case 'win32':
+      platformName = 'windows';
+      break;
+    default:
+      console.error('不支持的平台: ' + platform);
+      process.exit(1);
+  }
+
+  return `${platformName}_${mappedArch}`;
+}
+
+function getCacheDir() {
+  const dir = path.join(os.homedir(), '.devflow-skills', VERSION);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  return dir;
+}
+
+function downloadBinary(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest, { mode: 0o755 });
+    https
+      .get(url, (response) => {
+        if (response.statusCode === 302 || response.statusCode === 301) {
+          https.get(response.headers.location, (redirectRes) => {
+            redirectRes.pipe(file);
+            file.on('finish', () => {
+              file.close();
+              resolve();
+            });
+          }).on('error', reject);
+          return;
+        }
+        if (response.statusCode !== 200) {
+          reject(new Error(`下载失败 (HTTP ${response.statusCode}): ${url}`));
+          return;
+        }
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      })
+      .on('error', reject);
+  });
+}
+
+function getPackageDir() {
+  return path.dirname(require.resolve('./package.json'));
+}
+
+async function getBinary() {
+  const cacheDir = getCacheDir();
+  const binaryPath = path.join(cacheDir, BINARY_NAME);
+
+  if (fs.existsSync(binaryPath)) {
+    return binaryPath;
+  }
+
+  const pkgDir = getPackageDir();
+  const localBinary = path.join(pkgDir, BINARY_NAME);
+  if (fs.existsSync(localBinary)) {
+    process.stderr.write('使用本地构建的二进制。\n');
+    return localBinary;
+  }
+
+  const platform = getPlatform();
+  const suffix = process.platform === 'win32' ? '.exe' : '';
+  const url = `https://github.com/zhouhao4221/devflow-skills/releases/download/v${VERSION}/devflow-skills_${platform}${suffix}`;
+
+  process.stderr.write(`首次运行，正在下载 devflow-skills v${VERSION} (${platform})...\n`);
+
+  try {
+    await downloadBinary(url, binaryPath);
+    process.stderr.write('下载完成。\n');
+  } catch (e) {
+    process.stderr.write('下载失败，尝试本地构建...\n');
+    try {
+      const goBuild = spawnSync('go', ['build', '-o', binaryPath, pkgDir], {
+        cwd: pkgDir,
+        stdio: 'inherit',
+      });
+      if (goBuild.status === 0 && fs.existsSync(binaryPath)) {
+        return binaryPath;
+      }
+    } catch (_) {}
+
+    process.stderr.write('本地构建失败，尝试使用 go install...\n');
+    try {
+      const goInstall = spawnSync('go', ['install', `github.com/zhouhao4221/devflow-skills@v${VERSION}`], {
+        stdio: 'inherit',
+      });
+      if (goInstall.status !== 0) {
+        console.error('go install 失败。请确保已安装 Go 1.21+ 或手动下载二进制。');
+        console.error(`GitHub Releases: https://github.com/zhouhao4221/devflow-skills/releases/tag/v${VERSION}`);
+        process.exit(1);
+      }
+      const goBinPath = path.join(os.homedir(), 'go', 'bin', BINARY_NAME);
+      if (fs.existsSync(goBinPath)) {
+        fs.copyFileSync(goBinPath, binaryPath);
+        fs.chmodSync(binaryPath, 0o755);
+        return binaryPath;
+      }
+    } catch (e2) {
+      console.error('go install 失败:', e2.message);
+      process.exit(1);
+    }
+  }
+
+  fs.chmodSync(binaryPath, 0o755);
+  return binaryPath;
+}
+
+async function main() {
+  const binaryPath = await getBinary();
+  const result = spawnSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+  });
+  process.exit(result.status || 0);
+}
+
+main().catch((err) => {
+  console.error('运行失败:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@zhouhao4221/devflow-skills",
+  "version": "0.2.0",
+  "description": "一键安装/管理 devflow-skills AI 技能包",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhouhao4221/devflow-skills.git"
+  },
+  "bin": {
+    "devflow-skills": "install.js"
+  },
+  "files": [
+    "install.js",
+    "package.json"
+  ]
+}