cli-blueprint 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 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 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 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 those 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
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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,130 @@
+# dsh-skillpack
+
+**多 IDE 通用 skill 插件包** —— 一键安装 / 更新 / 卸载一组 skills，自动适配你本机已安装的每个 IDE，可无限扩展，可分发给任何人。
+
+默认包含：`blueprint`（CLI.Tax 工程规划 skill，`https://cli.tax/wvz6zmRWmX`）。
+
+## 这是什么机制？
+
+clitaxio 的本质只是从 `https://cli.tax/api/public/skills/{code}` 下载两个文件
+（`SKILL.md` + `skill.json`）并写入 IDE 的 skills 目录。本包把这个过程**固化成一个可版本化、
+可分发、可扩展的本地插件包**，并打通了 cli.tax 生态：
+
+- **自动拉取**：`sources.json` 里配置 cli.tax skill 源（如 `wvz6zmRWmX`），
+  `node install.mjs pull` 或 install 时自动从 cli.tax 拉取最新内容到 `skills/`（可提交进 git）
+- **自动匹配分发**：每个 skill 是一个目录：`skills/<name>/SKILL.md`；安装器自动检测本机
+  真实安装的 IDE，把 skill 分发到各 IDE 自己的用户级根（如 Codex 扫 `~/.codex/skills`、
+  DSH 扫 `~/.dsh/skills`），各一份、互不干扰
+- 共享兼容根 `~/.agents/skills` 默认跳过——它会被多个工具扫描，是"同一 skill 重复出现"的根源
+
+**与 clitaxio 的区别**：clitaxio 只把 skill 装到**一个** IDE 目录；本包是"拉取 + 多 IDE 自动分发"，
+装一次，本机所有已装 IDE 都能用。
+
+## 安装 / 更新 / 卸载
+
+```bash
+# 本地运行（无需发布）
+node install.mjs pull            # 从 cli.tax（sources.json）拉取最新 skill 到 skills/，可 git 提交
+node install.mjs install         # 自动匹配：skills/ 为空时自动先 pull，再分发到本机已装 IDE
+node install.mjs install --all   # 装到所有已知 IDE（不管是否安装）
+node install.mjs install --ide codex --ide dsh   # 只装指定 IDE（可重复）
+node install.mjs install --skip cursor       # 自动匹配但跳过指定 IDE（可重复）
+node install.mjs install --pull  # 强制重新从 cli.tax 拉取后再安装
+node install.mjs install --project  # 额外装到当前项目的项目级根
+node install.mjs install --agents   # 额外装到共享 ~/.agents/skills（警告：可能被多工具重复发现）
+node install.mjs install --target /abs/path      # 只装到自定义目录
+node install.mjs update             # 幂等覆盖，等同 install
+node install.mjs list               # 列出包内 skills
+node install.mjs ides               # 查看已知 IDE 及本机检测结果（✓ = 本机已装）
+node install.mjs uninstall          # 从相同目标卸载本包安装的 skills
+```
+
+**自动匹配说明**：默认安装会探测本机真实安装的 IDE（`which` 命令 / 应用路径 / 配置文件），
+只装给已安装的 IDE，让每个 IDE 自己识别需要的 skill。用 `node install.mjs ides` 查看
+本机检测结果（✓ = 已安装）。
+
+## 支持的 IDE（全世界已知安装位置，官方文档核实）
+
+| IDE | 用户级根 | 项目级根 | 说明 |
+|---|---|---|---|
+| Codex CLI | `~/.codex/skills` | `.codex/skills` | 新官方约定 `~/.agents/skills`；此处用专属根避免共享冲突 |
+| DSH | `~/.dsh/skills` | `.dsh/skills` | skill-filesystem 自动扫描 |
+| Claude Code | `~/.claude/skills` | `.claude/skills` | 父目录向上扫描至 repo root |
+| Gemini CLI | `~/.gemini/skills` | `.gemini/skills` | 别名 `.agents/skills` 优先级更高 |
+| Google Antigravity | `~/.gemini/antigravity/skills` | `.agents/skills`（随 --agents） | workspace 级固定用 agents 标准 |
+| Cursor | `~/.cursor/skills` | `.cursor/skills` | 兼容加载 .claude/.codex/.agents/skills |
+| Cline | `~/.cline/skills` | `.cline/skills` | 全局优先于项目 |
+| Roo Code | `~/.roo/skills` | `.roo/skills` | 项目覆盖全局 |
+| Kilo Code | `~/.kilo/skills` | `.kilo/skills` | kilo.jsonc 可配 |
+| Windsurf | `~/.codeium/windsurf/skills` | `.windsurf/skills` | Cascade Skills |
+| VS Code / Copilot | `~/.copilot/skills` | `.github/skills` | 另兼容 .claude/skills |
+| Trae | `~/.trae-cn/skills`（国内版） | `.trae/skills` | 国际版用户级未确认 |
+| Qwen Code | `~/.qwen/skills` | `.qwen/skills` | 模型自动调用 |
+| OpenCode | `~/.config/opencode/skills` | `.opencode/skills` | 兼容 .claude/.agents |
+| Zed | `~/.agents/skills`（仅 --agents） | `.agents/skills`（仅 --agents） | 官方即用 agents 标准根 |
+| Amazon Q | 无 skills 机制 | 无 skills 机制 | 官方确认不支持 SKILL.md |
+
+> 跨工具互操作标准根 `~/.agents/skills`（agentskills.io）：Codex 新约定、Gemini、Zed、
+> OpenCode、Cursor、Antigravity、Kilo 等都支持，但会被**多个工具同时扫描**——同一 skill
+> 装进去会在各工具中重复出现。本安装器默认跳过它（`--agents` 显式开启并警告）。
+>
+> 新增 IDE：在 `install.mjs` 的 `IDES` 数组加一行即可，其余逻辑自动生效。
+
+## 分发给别人
+
+### 方式 A：Git 仓库（推荐，最简单）
+把本目录推到一个 git 仓库，使用者：
+```bash
+git clone <repo-url> && cd dsh-skillpack && node install.mjs install
+```
+更新：`git pull && node install.mjs update`
+
+### 方式 B：发布为 npm 包（一条命令装）
+本包已配好 `bin`，发布后使用者只需：
+```bash
+npx dsh-skillpack@latest install
+```
+更新：同一命令（`@latest` 自动拉新版）。
+> 注意 npm 官方源对包名唯一性有要求；内部使用可部署私有 registry（如 Verdaccio）。
+
+### 方式 C：直接用 clitaxio（如果只想引第三方 skill）
+```bash
+npx clitaxio@latest install <runtime-code> ~/.codex/skills/<slug>
+```
+本包是更可控的本地化替代：离线可用、可审计、可 git 管理、可批量管理多个 skill、自动多 IDE 分发。
+
+## 目录结构
+
+```
+dsh-skillpack/
+├── install.mjs       # 安装器（Node ≥18，零依赖）：pull / install / uninstall / list / ides
+├── sources.json      # ★ cli.tax skill 源清单（code → 自动拉取），扩展就加一行
+├── package.json      # npm 包元数据（可发布）
+├── README.md
+└── skills/           # skill 内容（pull 生成，可提交 git 离线兜底）
+    └── blueprint/
+        ├── SKILL.md
+        └── skill.json
+```
+
+## 无限扩展（加新 skill 两种方式）
+
+**方式 A：从 cli.tax 拉取**（推荐）——`sources.json` 加一行：
+```json
+{ "cliTax": [
+  { "code": "wvz6zmRWmX", "slug": "blueprint", "endpoint": "https://cli.tax/api/public/skills/{code}" },
+  { "code": "你的新code", "slug": "新skill名", "endpoint": "https://cli.tax/api/public/skills/{code}" }
+] }
+```
+然后 `node install.mjs pull` → 自动下载到 skills/。
+
+**方式 B：本地手工写**——直接建 `skills/my-new-skill/SKILL.md`（frontmatter: `name` kebab-case + `description`）。
+
+两种方式后都只需 `node install.mjs update` 同步到本机所有已装 IDE。
+
+## 常见问题
+
+- **装完当前会话没立刻出现？** skill 目录在会话初始化时注入，新会话即可发现；文件系统 watcher 也会自动感知变更。
+- **Codex 里出现了 2 个同一个 skill？** 常见原因是同时存在 `~/.codex/skills/<name>` 和 `~/.agents/skills/<name>`（或 config.toml 注册条目）。本安装器默认不会装到 `~/.agents/skills`，避免此问题；如已发生，删除 `~/.agents/skills/<name>` 并清理 config.toml 中的 `[[skills.config]]` 条目即可。
+- **想改 skill 内容？** 直接改 `skills/<name>/SKILL.md` 再 `update`，幂等覆盖。
+- **命名要求？** 目录名即 skill 名，必须 kebab-case（如 `my-new-skill`）。

package/install.mjs

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+/**
+ * dsh-skillpack — 多 IDE 通用 skill 插件包安装器
+ *
+ * 从本包 `skills/` 目录同步一组 skill 到全世界各 IDE/编码 agent 的 skills 根目录。
+ * 每个子目录（含 SKILL.md + skill.json）即一个 skill；新增/删除子目录后重跑即可扩展。
+ *
+ * 设计原则：
+ *   - 内置「全世界已知 IDE 的 skills 安装位置表」（IDES，官方文档核实）；
+ *   - 默认「自动匹配」：检测本机真实安装的 IDE（which 命令 / 应用路径 / 配置文件），
+ *     只装给已安装的 IDE，让每个 IDE 自己识别需要的 skill；--all 才全量安装；
+ *   - 每个 IDE 装到它自己的专属用户级根 → IDE 内部唯一、IDE 之间互不重复；
+ *   - 跨工具互操作标准 ~/.agents/skills（agentskills.io）默认跳过——它会被多个工具
+ *     同时扫描（Codex 新约定/Gemini/Zed/OpenCode/Cursor/Antigravity），装进去会被重复发现；
+ *     需要时用 --agents 显式开启（会打印警告）；
+ *   - --ide / --skip 精确控制；新增 IDE 只需在 IDES 表加一行。
+ *
+ * 用法:
+ *   node install.mjs pull                  # 从 sources.json（cli.tax）拉取全部 skill 到 skills/
+ *   node install.mjs install               # 自动匹配：只装本机已安装的 IDE（推荐）
+ *                                          #   skills/ 为空时自动先 pull；--pull 强制重新拉取
+ *   node install.mjs install --all         # 装到所有已知 IDE（不管是否安装）
+ *   node install.mjs install --ide codex   # 仅安装到指定 IDE（可重复: --ide codex --ide dsh）
+ *   node install.mjs install --skip cursor # 自动匹配但跳过指定 IDE（可重复）
+ *   node install.mjs install --project     # 额外安装到当前项目的项目级根（每个选中 IDE 一个）
+ *   node install.mjs install --agents      # 额外安装到共享 ~/.agents/skills（警告）
+ *   node install.mjs install --target /abs/path    # 仅自定义目录
+ *   node install.mjs update                # 同 install（幂等覆盖）
+ *   node install.mjs uninstall             # 从相同目标移除本包安装的 skills
+ *   node install.mjs list                  # 列出本包包含的 skills
+ *   node install.mjs ides                  # 列出已知 IDE 及本机检测结果
+ *
+ * 作为 npm 包发布后:  npx dsh-skillpack@latest install
+ */
+import { cp, mkdir, readdir, rm, writeFile } from 'node:fs/promises'
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url))
+const SKILLS_SRC = join(__dirname, 'skills')
+
+const HOME = homedir()
+const CWD = process.cwd()
+
+/**
+ * 全世界已知 IDE/编码 agent 的 skills 安装位置表（官方文档核实，2026-08）。
+ *   key:     命令行标识
+ *   label:   显示名
+ *   detect:  安装探测规则数组（任一命中即视为已安装）：
+ *              { cmd: 'codex' }               —— which 命令存在
+ *              { app: '/Applications/X.app' } —— 应用路径存在
+ *              { file: '~/.codex/config.toml' } —— 配置文件存在（确认真实安装，非本工具创建）
+ *   user:    用户级 skills 根（默认安装目标，每个 IDE 一份）
+ *   project: 项目级 skills 根（--project 时使用）
+ *   doc:     官方文档 URL
+ * 新增 IDE 只需在此加一行，其余逻辑自动生效。
+ */
+const IDES = [
+  // OpenAI / Anthropic / Google 系
+  { key: 'codex', label: 'Codex CLI', detect: [{ cmd: 'codex' }, { file: join(HOME, '.codex', 'config.toml') }], user: join(HOME, '.codex', 'skills'), project: join(CWD, '.codex', 'skills'), doc: 'https://developers.openai.com/codex/skills', note: '新官方约定 ~/.agents/skills；此处用旧约定 ~/.codex/skills（skill-installer 仍默认写入），避免共享根重复' },
+  { key: 'dsh', label: 'DSH', detect: [{ file: join(HOME, '.dsh', 'settings.yaml') }, { file: join(HOME, '.dsh', '.credentials.yaml') }], user: join(HOME, '.dsh', 'skills'), project: join(CWD, '.dsh', 'skills'), doc: 'https://github.com/deepseek-ai/Harness', note: 'skill-filesystem 扫描 ~/.dsh/skills + ~/.agents/skills' },
+  { key: 'claude', label: 'Claude Code', detect: [{ cmd: 'claude' }, { file: join(HOME, '.claude', 'settings.json') }, { dir: join(HOME, '.claude') }], user: join(HOME, '.claude', 'skills'), project: join(CWD, '.claude', 'skills'), doc: 'https://code.claude.com/docs/en/skills', note: '含父目录向上扫描至 repo root；monorepo 子目录生效' },
+  { key: 'gemini', label: 'Gemini CLI', detect: [{ cmd: 'gemini' }, { file: join(HOME, '.gemini', 'settings.json') }], user: join(HOME, '.gemini', 'skills'), project: join(CWD, '.gemini', 'skills'), doc: 'https://geminicli.com/docs/cli/skills/', note: '别名 .agents/skills 优先级更高（此处用专属根避免共享冲突）' },
+  { key: 'antigravity', label: 'Google Antigravity', detect: [{ cmd: 'antigravity' }, { app: '/Applications/Antigravity.app' }], user: join(HOME, '.gemini', 'antigravity', 'skills'), project: join(CWD, '.agents', 'skills'), doc: 'https://antigravity.google/docs/ide/skills', note: 'workspace 级固定用 .agents/skills（需 --agents 才装项目级）' },
+
+  // 编辑器 / VS Code 生态
+  { key: 'cursor', label: 'Cursor', detect: [{ cmd: 'cursor' }, { app: '/Applications/Cursor.app' }, { file: join(HOME, '.cursor', 'cursor.db') }], user: join(HOME, '.cursor', 'skills'), project: join(CWD, '.cursor', 'skills'), doc: 'https://cursor.com/help/customization/skills.md', note: '兼容加载 .claude/.codex/.agents/skills' },
+  { key: 'cline', label: 'Cline', detect: [{ cmd: 'cline' }, { dir: join(HOME, '.cline') }], user: join(HOME, '.cline', 'skills'), project: join(CWD, '.cline', 'skills'), doc: 'https://cline.bot/blog/cline-3-48-0-skills-and-websearch-make-cline-smarter', note: '全局优先于项目' },
+  { key: 'roo', label: 'Roo Code', detect: [{ cmd: 'roo' }, { dir: join(HOME, '.roo') }], user: join(HOME, '.roo', 'skills'), project: join(CWD, '.roo', 'skills'), doc: 'https://docs.roocode.com/features/skills', note: '项目覆盖全局，模式级覆盖通用' },
+  { key: 'kilo', label: 'Kilo Code', detect: [{ cmd: 'kilo' }, { dir: join(HOME, '.kilo') }], user: join(HOME, '.kilo', 'skills'), project: join(CWD, '.kilo', 'skills'), doc: 'https://kilo.ai/docs/customize/skills', note: 'kilo.jsonc 可配 skills.paths/urls；另默认加载 .agents/skills' },
+  { key: 'windsurf', label: 'Windsurf', detect: [{ cmd: 'windsurf' }, { app: '/Applications/Windsurf.app' }], user: join(HOME, '.codeium', 'windsurf', 'skills'), project: join(CWD, '.windsurf', 'skills'), doc: 'https://docs.windsurf.com/windsurf/cascade/skills', note: '全局 ~/.codeium/windsurf/skills，workspace .windsurf/skills' },
+  { key: 'copilot', label: 'VS Code / Copilot', detect: [{ cmd: 'copilot' }, { app: '/Applications/Visual Studio Code.app' }, { file: join(HOME, '.copilot', 'accounts.json') }], user: join(HOME, '.copilot', 'skills'), project: join(CWD, '.github', 'skills'), doc: 'https://code.visualstudio.com/docs/agent-customization/agent-skills', note: 'workspace .github/skills + .claude/skills；user ~/.copilot/skills + ~/.claude/skills' },
+  { key: 'trae', label: 'Trae', detect: [{ cmd: 'trae' }, { app: '/Applications/Trae.app' }, { dir: join(HOME, '.trae-cn') }], user: join(HOME, '.trae-cn', 'skills'), project: join(CWD, '.trae', 'skills'), doc: 'https://docs.trae.cn/work_skills', note: '国内版 ~/.trae-cn/skills；国际版用户级未确认；另有 .trae/rules' },
+
+  // CLI agent
+  { key: 'qwen', label: 'Qwen Code', detect: [{ cmd: 'qwen' }, { file: join(HOME, '.qwen', 'settings.json') }], user: join(HOME, '.qwen', 'skills'), project: join(CWD, '.qwen', 'skills'), doc: 'https://qwenlm.github.io/qwen-code-docs/users/features/skills/', note: '模型自动调用；/learn 生成到项目 .qwen/skills' },
+  { key: 'opencode', label: 'OpenCode', detect: [{ cmd: 'opencode' }, { dir: join(HOME, '.config', 'opencode') }], user: join(HOME, '.config', 'opencode', 'skills'), project: join(CWD, '.opencode', 'skills'), doc: 'https://github.com/anomalyco/opencode/blob/main/packages/web/src/content/docs/skills.mdx', note: '兼容 .claude/skills 与 .agents/skills' },
+  { key: 'zed', label: 'Zed', detect: [{ cmd: 'zed' }, { app: '/Applications/Zed.app' }], user: join(HOME, '.agents', 'skills'), project: join(CWD, '.agents', 'skills'), doc: 'https://zed.dev/docs/ai/skills', note: '官方即用 .agents/skills 标准根，仅 --agents 时安装（避免默认触碰共享根）', agentsOnly: true },
+  // Amazon Q Developer：官方确认无 SKILL.md skills 机制（能力目录为 ~/.aws/amazonq/cli-agents/），故不入表
+]
+
+// 跨工具互操作标准根（默认跳过；--agents 显式开启）
+const AGENTS = { label: '共享 agents 级 (.agents/skills 标准)', path: join(HOME, '.agents', 'skills') }
+
+function print(line = '') { process.stdout.write(`${line}\n`) }
+
+/** 探测 IDE 是否真实安装（which 命令 / 应用路径 / 配置文件，任一命中即已安装） */
+function isIdeInstalled(ide) {
+  for (const probe of ide.detect) {
+    if (probe.cmd !== undefined) {
+      const r = spawnSync('which', [probe.cmd], { stdio: 'ignore' })
+      if (r.status === 0) return true
+    }
+    if (probe.app !== undefined && existsSync(probe.app)) return true
+    if (probe.file !== undefined && existsSync(probe.file)) return true
+    if (probe.dir !== undefined) {
+      // 目录存在且包含非 skills 的真实内容（避免本安装器创建的 skills 子目录误判）
+      try {
+        const entries = readdirSync(probe.dir)
+        if (entries.some((e) => e !== 'skills' && e !== '.git')) return true
+      } catch { /* 目录不存在或不可读，忽略 */ }
+    }
+  }
+  return false
+}
+
+async function listSkills() {
+  if (!existsSync(SKILLS_SRC)) return []
+  const entries = await readdir(SKILLS_SRC, { withFileTypes: true })
+  const skills = []
+  for (const e of entries) {
+    if (!e.isDirectory()) continue
+    const skillDir = join(SKILLS_SRC, e.name)
+    if (existsSync(join(skillDir, 'SKILL.md'))) skills.push(e.name)
+  }
+  return skills.sort()
+}
+
+async function syncOne(name, targetRoot, { remove = false } = {}) {
+  const dest = join(targetRoot, name)
+  if (remove) {
+    if (existsSync(dest)) { await rm(dest, { recursive: true, force: true }); print(`  ✓ 已移除 ${name} ← ${targetRoot}`) }
+    return
+  }
+  await mkdir(dest, { recursive: true })
+  await cp(join(SKILLS_SRC, name), dest, { recursive: true, force: true })
+  print(`  ✓ 已安装 ${name} → ${dest}`)
+}
+
+async function syncAll(targetRoot, { remove = false } = {}) {
+  const skills = await listSkills()
+  if (!remove) await mkdir(targetRoot, { recursive: true })
+  for (const s of skills) await syncOne(s, targetRoot, { remove })
+}
+
+/** 解析目标列表：--target / --ide / --skip / 默认（全部已知 IDE） */
+function parseTargets(args) {
+  const flags = args.filter((a) => a.startsWith('--'))
+
+  const targetFlag = args.indexOf('--target')
+  if (targetFlag !== -1) {
+    const p = args[targetFlag + 1]
+    if (!p) { print('--target 需要一个绝对路径'); process.exit(1) }
+    return [{ label: '自定义', path: resolve(p) }]
+  }
+
+  const selected = []
+  const withProject = flags.includes('--project')
+
+  // 显式 --ide（可重复）
+  const ideKeys = []
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--ide') {
+      const k = args[i + 1]
+      if (!k) { print('--ide 需要一个 IDE key（如 codex）'); process.exit(1) }
+      ideKeys.push(k)
+      i++
+    }
+  }
+  if (ideKeys.length) {
+    for (const k of ideKeys) {
+      const ide = IDES.find((x) => x.key === k)
+      if (!ide) { print(`未知 IDE: ${k}（可用: ${IDES.map((x) => x.key).join(', ')}）`); process.exit(1) }
+      selected.push({ label: `${ide.label} 用户级`, path: ide.user })
+      if (withProject) selected.push({ label: `${ide.label} 项目级`, path: ide.project })
+    }
+    return selected
+  }
+
+  // --skip（排除某些 IDE）
+  const skipped = []
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--skip') {
+      const k = args[i + 1]
+      if (!k) { print('--skip 需要一个 IDE key（如 cursor）'); process.exit(1) }
+      skipped.push(k)
+      i++
+    }
+  }
+
+  // 默认：自动匹配——只装本机真实安装的 IDE；--all 则装全部已知 IDE。
+  const wantAgents = flags.includes('--agents')
+  const wantAll = flags.includes('--all')
+  for (const ide of IDES) {
+    if (skipped.includes(ide.key)) continue
+    // agentsOnly（如 Zed）：仅 --agents 时安装，默认不触碰共享根
+    if (ide.agentsOnly && !wantAgents) continue
+    // 默认只装检测到已安装的 IDE；--all 忽略检测
+    if (!wantAll && !isIdeInstalled(ide)) continue
+    selected.push({ label: `${ide.label} 用户级`, path: ide.user })
+    if (withProject) selected.push({ label: `${ide.label} 项目级`, path: ide.project })
+  }
+  if (!selected.length) {
+    print('未检测到任何已安装的 IDE；可用 --all 安装全部已知 IDE，或 --ide <key> 指定。')
+    process.exit(1)
+  }
+  return selected
+}
+
+const [cmd, ...rest] = process.argv.slice(2)
+
+/** 从 cli.tax 拉取一个 skill 到 skills/<slug>/（覆盖本地副本） */
+async function pullSkill(source) {
+  const url = source.endpoint.replace('{code}', source.code)
+  const resp = await fetch(url)
+  if (!resp.ok) {
+    print(`  ✗ 拉取失败 ${source.slug}（${url} → HTTP ${resp.status}）`)
+    return false
+  }
+  const data = await resp.json()
+  const dir = join(SKILLS_SRC, data.slug || source.slug)
+  await mkdir(dir, { recursive: true })
+  await writeFile(join(dir, 'SKILL.md'), data.skillMd)
+  await writeFile(join(dir, 'skill.json'), data.skillJson)
+  print(`  ✓ 已拉取 ${data.displayName} ${data.version ?? ''} → skills/${data.slug}/`)
+  return true
+}
+
+/** 读取 sources.json 中的源列表 */
+function loadSources() {
+  const p = join(__dirname, 'sources.json')
+  if (!existsSync(p)) return []
+  try {
+    const raw = readFileSync(p, 'utf8')
+    return JSON.parse(raw).cliTax ?? []
+  } catch {
+    print('⚠ sources.json 解析失败，忽略源。')
+    return []
+  }
+}
+
+/** 拉取全部源；失败不影响本地已有 skills */
+async function pullAllSources() {
+  const sources = loadSources()
+  if (!sources.length) return false
+  print(`从 cli.tax 拉取 ${sources.length} 个 skill 源:`)
+  let ok = 0
+  for (const s of sources) { if (await pullSkill(s)) ok++ }
+  print(`拉取完成（${ok}/${sources.length}）。`)
+  return ok > 0
+}
+
+if (cmd === 'list') {
+  const skills = await listSkills()
+  print(`本包包含 ${skills.length} 个 skills:`)
+  for (const s of skills) print(`  - ${s}`)
+} else if (cmd === 'ides') {
+  print(`已知 IDE 及本机检测结果（共 ${IDES.length} 个）:`)
+  for (const ide of IDES) {
+    const installed = isIdeInstalled(ide)
+    print(`  ${installed ? '✓' : '·'} ${ide.key.padEnd(11)} ${ide.label.padEnd(20)} ${ide.user}`)
+  }
+  print(`  · agents     共享 agents 级  ${AGENTS.path}（默认跳过，--agents 开启）`)
+  print('默认 install 只装 ✓ 标记的 IDE；--all 装全部。')
+} else if (cmd === 'pull') {
+  const ok = await pullAllSources()
+  if (ok) print('已更新 skills/ 目录；可用 git add/commit 提交到仓库。')
+  process.exit(ok ? 0 : 1)
+} else if (cmd === 'install' || cmd === 'update') {
+  // 自动拉取：--pull 强制拉取；skills/ 为空时也自动拉取
+  if (rest.includes('--pull') || !existsSync(SKILLS_SRC) || (await readdir(SKILLS_SRC).catch(() => [])).length === 0) {
+    await pullAllSources()
+  }
+  const targets = parseTargets(rest)
+  const skills = await listSkills()
+  if (!skills.length) { print('skills/ 目录为空，无法安装'); process.exit(1) }
+  if (rest.includes('--agents') && !targets.some((t) => t.path === AGENTS.path)) targets.push(AGENTS)
+  print(`将安装 ${skills.length} 个 skills → ${targets.length} 个目标`)
+  for (const t of targets) {
+    print(`[${t.label}] ${t.path}`)
+    await syncAll(t.path)
+  }
+  if (rest.includes('--agents')) {
+    print('⚠ 已安装到共享 ~/.agents/skills：该目录会被 Codex/Gemini/Zed/OpenCode/Cursor 等同时扫描，同一 skill 可能被重复发现。')
+  }
+  print('完成。各 IDE 会自动发现各自用户级根中的新目录（可立即在新会话中调用）。')
+} else if (cmd === 'uninstall') {
+  const targets = parseTargets(rest)
+  if (rest.includes('--agents') && !targets.some((t) => t.path === AGENTS.path)) targets.push(AGENTS)
+  for (const t of targets) {
+    print(`[${t.label}] ${t.path}`)
+    await syncAll(t.path, { remove: true })
+  }
+  print('完成。')
+} else {
+  print(`用法:
+  node install.mjs install [--all|--ide <key>|--skip <key>|--project|--agents|--pull|--target <dir>]
+  node install.mjs pull
+  node install.mjs update
+  node install.mjs uninstall
+  node install.mjs list
+  node install.mjs ides`)
+  process.exit(1)
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "cli-blueprint",
+  "version": "0.1.0",
+  "description": "Blueprint skill 多 IDE 安装器：从 cli.tax 自动拉取并分发到本机所有已装 IDE（Codex/DSH/Claude/Cursor/…）。",
+  "type": "module",
+  "bin": {
+    "cli-blueprint": "install.mjs"
+  },
+  "files": [
+    "install.mjs",
+    "sources.json",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "keywords": [
+    "blueprint",
+    "skill",
+    "cli.tax",
+    "clitax",
+    "codex",
+    "agent",
+    "installer"
+  ]
+}

package/skills/blueprint/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: "blueprint"
+description: "Blueprint 是一个跨工具的工程规划 CLI，把明确目标编译为可执行、可追溯、可验收的全站工程蓝图，并通过确定性规则检查每个节点、分支、合同、任务与验收闭环。默认由当前 IDE 的多智能体协同推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥。"
+---
+
+# blueprint
+
+Use this Skill only when the user's request matches the capability described below.
+
+## Capability
+
+- Source type: Skill
+- Version: v0.4.0
+- Status at generation: published
+- Address: `https://cli.tax/wvz6zmRWmX`
+- Method: `POST`
+- Content type: `application/json`
+
+Blueprint 是一个跨工具的工程规划 CLI，把明确目标编译为可执行、可追溯、可验收的全站工程蓝图，并通过确定性规则检查每个节点、分支、合同、任务与验收闭环。默认由当前 IDE 的多智能体协同推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥。
+
+## Invocation
+
+Send JSON to the exact CLI address and put capability arguments inside `input`:
+
+```json
+{
+  "input": {}
+}
+```
+
+Do not rewrite the CLI address, invent parameters, or include API keys, tokens, cookies, passwords, or private keys. Ask for missing non-secret inputs. Runtime invocation is available only after the CLI is published and the owner has an active subscription.
+
+## Errors
+
+- `402`: subscription or quota unavailable
+- `404`: CLI is unavailable or not published
+- `422`: invalid input or contract
+- `429`: rate or concurrency limit reached
+- `5xx`: execution or upstream failure

package/skills/blueprint/skill.json

@@ -0,0 +1,10 @@
+{
+  "name": "blueprint",
+  "displayName": "blueprint",
+  "description": "Blueprint 是一个跨工具的工程规划 CLI，把明确目标编译为可执行、可追溯、可验收的全站工程蓝图，并通过确定性规则检查每个节点、分支、合同、任务与验收闭环。默认由当前 IDE 的多智能体协同推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥。",
+  "schemaVersion": "cli.request/1.0",
+  "endpoint": "https://cli.tax/wvz6zmRWmX",
+  "method": "POST",
+  "version": "v0.4.0",
+  "type": "Skill"
+}

package/sources.json

@@ -0,0 +1,11 @@
+{
+  "cliTax": [
+    {
+      "code": "wvz6zmRWmX",
+      "slug": "blueprint",
+      "endpoint": "https://cli.tax/api/public/skills/{code}",
+      "doc": "https://cli.tax/wvz6zmRWmX",
+      "description": "Blueprint 工程规划 CLI skill（CLI.Tax 发布）"
+    }
+  ]
+}