moluoxixi-ai-rules 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moluoxixi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README-zh.md

@@ -0,0 +1,246 @@
+# Moluoxixi AIRules
+
+> 🧩 用"乐高积木"的方式，拼装你自己的 AI 编程最佳实践。
+
+**[English](README.md)** | **中文**
+
+## 这是什么？
+
+AIRules 是一个**可组合的 AI 技能分发系统**。它的核心思想很简单：
+
+- **克隆**业界成熟的 AI Skills（来自 antfu、Anthropic、Google Gemini、Vercel 等）
+- **编写**你自己的领域专属 Skills
+- **组合**这些小单元模块，形成你个人的开发生态最佳实践
+- **一键分发**到所有 AI 代理（Claude、Cursor、Codex、Gemini 等）
+
+## 核心理念
+
+### 🏗️ 三层架构
+
+```
+┌─────────────────────────────────────────────┐
+│  🔧 第一方 Skills（你自己写的）                │ ← 你的核心竞争力
+│  software-development-workflow / 标准集合      │
+├─────────────────────────────────────────────┤
+│  📦 第三方 Skills（克隆成熟仓库）              │ ← 站在巨人肩膀上
+│  antfu/vue · anthropic/design · gemini/... │
+├─────────────────────────────────────────────┤
+│  🚀 分发引擎（一键安装到所有 AI 代理）         │ ← 自动化基础设施
+│  Claude · Cursor · Codex · Gemini · ...     │
+└─────────────────────────────────────────────┘
+```
+
+### 📐 设计原则
+
+| 原则 | 说明 |
+|------|------|
+| **小单元模块化** | 每个 skill 只做一件事，独立、可测试、可替换 |
+| **组合 > 大而全** | 像 Unix 管道一样，通过组合小工具解决大问题 |
+| **第三方优先** | 能用成熟的就不自己写，自己只写真正有独特价值的部分 |
+| **自愈式分发** | 一条命令同步到所有 AI 代理，自动处理软链接、依赖、验证 |
+
+## 你能得到什么？
+
+- 🔥 **开箱即得** 25+ 精选前端/后端/通用 AI Skills
+- 🧱 **预留第一方扩展位**：保留顶层自定义 skills 投影入口，后续补充时无需调整整体分发模型
+- 🌐 **多代理同步**：一次配置，Claude / Cursor / Codex / Qoder / Tare / OpenCode / CC-Switch 全部生效
+- 🔄 **持续更新**：上游 skills 更新后，一条命令同步最新版本
+
+## 安装
+
+**作为 Node CLI 使用（本地开发 / npm link）：**
+
+```bash
+npm install
+npm run build
+npm link
+airules sync --host all
+```
+
+添加本地 skill 并同步到所有宿主：
+
+```bash
+airules add ./my-skill --host all
+```
+
+`add` 命令要求源目录包含 `SKILL.md`，并会复制到 `~/.moluoxixi/skills/<skill-name>`，再通过同一套 vendor/host 投影链路同步。
+
+**macOS / Linux / Git Bash：**
+
+```bash
+git clone https://github.com/moluoxixi/AIRules.git "$HOME/.moluoxixi"
+cd "$HOME/.moluoxixi"
+npm run sync
+```
+
+**Windows CMD：**
+
+```cmd
+git clone https://github.com/moluoxixi/AIRules.git "%USERPROFILE%\.moluoxixi"
+cd "%USERPROFILE%\.moluoxixi"
+npm run sync
+```
+
+**Windows PowerShell：**
+
+```powershell
+git clone https://github.com/moluoxixi/AIRules.git "$env:USERPROFILE\.moluoxixi"
+cd "$env:USERPROFILE\.moluoxixi"
+npm run sync
+```
+
+> [!TIP]
+> **同步流程**：该命令会重建 vendor skills、清理死链接，并在完成后自动运行宿主验证。需要避免拉取第三方供应商时，可使用 `airules sync --skip-vendors`。
+
+---
+
+## 发布
+
+发布由 `.github/workflows/publish.yml` 负责。
+
+1. 创建具备发布权限的 npm automation token，并保存为 GitHub Actions 仓库 secret：`NPM_TOKEN`。
+2. 将 `package.json` 升到准备发布的版本，然后推送匹配的 Git tag，例如 `v0.1.0`。
+3. 推送 tag 会自动发布；也可以在 Actions 页面手动运行 `Publish package` workflow 并填写已有 tag。
+4. workflow 会安装依赖、校验 tag 与 `package.json` 版本一致、执行 lint/typecheck/tests，然后通过 `npm publish --provenance --access public` 发布到 npm。
+
+当前 workflow 使用 `npm install`，因为本仓库有意不跟踪 lockfile。
+
+---
+
+## 特定宿主安装
+
+**macOS / Linux / Git Bash：**
+
+```bash
+git clone https://github.com/moluoxixi/AIRules.git "$HOME/.moluoxixi"
+cd "$HOME/.moluoxixi"
+npm run rules:install -- --host 宿主名（例如 claude）
+```
+
+**Windows CMD：**
+
+```cmd
+git clone https://github.com/moluoxixi/AIRules.git "%USERPROFILE%\.moluoxixi"
+cd "%USERPROFILE%\.moluoxixi"
+npm run rules:install -- --host 宿主名（例如 claude）
+```
+
+**Windows PowerShell：**
+
+```powershell
+git clone https://github.com/moluoxixi/AIRules.git "$env:USERPROFILE\.moluoxixi"
+cd "$env:USERPROFILE\.moluoxixi"
+npm run rules:install -- --host 宿主名（例如 claude）
+```
+
+> [!TIP]
+> 仓库内也可以继续使用 `npm run rules:install -- --host claude`，该脚本现在等价转发到 `airules sync`。
+
+---
+
+## CLI 命令
+
+| 命令 | 作用 |
+|------|------|
+| `airules sync --host all` | 同步内置、用户自定义和第三方 skills 到所有已存在宿主 |
+| `airules add ./my-skill --host all` | 添加本地 skill，并同步到所有宿主 |
+| `airules add ./my-skill --name review-plus --overwrite` | 指定安装名并覆盖已有用户 skill |
+| `airules verify --host codex` | 校验指定宿主的 skills 链接完整性 |
+
+常用选项：
+
+| 选项 | 说明 |
+|------|------|
+| `--home <dir>` | 指定 AIRules 安装目录，默认 `~/.moluoxixi` |
+| `--user-home <dir>` | 指定宿主配置所在的用户目录，默认当前系统用户目录 |
+| `--host <name\|all>` | 指定宿主，默认 `all` |
+| `--skip-vendors` | `sync` 时不刷新第三方 vendor 仓库 |
+| `--skip-sync` | `add` 后只写入用户 skill，不立即同步宿主 |
+| `--no-verify` | 跳过宿主验证 |
+
+---
+
+### 宿主支持矩阵
+
+Moluoxixi AIRules 通过自动化投影，支持不断增长的 AI 代理生态系统：
+
+| 代理 | `--host` 参数 | 宿主路径 | 投影方式 | 引导文件 |
+|-------|---------------|----------|----------|----------|
+| **Claude Code** | `claude` | `~/.claude/` | 软链接 | `CLAUDE.md` |
+| **Codex** | `codex` | `~/.codex/` | 软链接 | `AGENTS.md` |
+| **Cursor** | `cursor` | `~/.cursor/` | 软链接 | `AGENTS.md` |
+| **Tare** | `tare` | `~/.tare/` | 软链接 | `AGENTS.md` |
+| **OpenCode** | `opencode` | `~/.config/opencode/` | 软链接 | `AGENTS.md` |
+| **CC-Switch** | `cc-switch` | `~/.cc-switch/` | 软链接 | `AGENTS.md` |
+
+> [!NOTE]
+> 所有技能在安装过程中都会自动投影到代理专属的 skills 目录中。
+
+---
+
+## Skills 全景图
+
+### 第一方 Skills（自写）
+
+| 名称 | 描述 |
+|------|------|
+| **software-development-workflow** | 通用软件开发标准流程：需求、拆分、设计、实现、验证、复核与交付报告 |
+| **frontend-code-standard** | Vue 3 与 React TypeScript/JavaScript 前端编码标准：统一组件、模块、工具库和 UI 组件库规则，覆盖评审输出、边界、导出、import 路径、类型契约与交付检查 |
+| **node-code-standard** | Node.js 后端实现标准：适用于 TypeScript/JavaScript 服务，覆盖显式契约、运行时校验、依赖注入、事务边界、持久化封装与交付检查 |
+| **nestjs-code-standard** | NestJS 后端实现与评审标准：面向新写、重构和代码评审，覆盖 DTO 契约、ValidationPipe、构造函数注入、事务边界、持久化封装和基于证据的评审输出 |
+| **java-code-standard** | Java 与 Spring Boot 后端编码标准：适用于 Java 17+ 基线、Java 21/25 LTS、Maven 和 Gradle，覆盖领域包、构造函数注入、Bean Validation、事务边界、迁移与错误映射 |
+| **skill-validation-standard** | 最小 Skill 产物校验标准：校验生成或修改后的 Claude/Codex skill 的 SKILL.md YAML frontmatter、文件夹命名一致性和行数限制 |
+
+> workflow 标准可以继续放在 `skills/workflow` 等嵌套源目录下，但安装时会展平为 `vendor/skills/<skill-name>`；仓库级规则位于 `rules/AGENTS.md`。
+
+### 第三方 Skills（精选）
+
+| 来源 | Skills | 说明 |
+|------|--------|------|
+| **antfu** | vue, nuxt, pinia, vite, vitest, unocss, pnpm, vitepress, slidev, tsdown, turborepo 等 15 个 | Vue 全家桶 + 前端工具链最佳实践 |
+| **Google Gemini** | code-reviewer, pr-creator | 代码审查与 PR 自动创建 |
+| **Vercel Labs** | find-skills | 开源生态 Skill 发现与安装 |
+| **Vercel Agent Skills** | react-best-practices, react-native-skills, web-design-guidelines | React/React Native 实现指导与 Web UI 审查 |
+| **Anthropic** | frontend-design | 生产级前端视觉设计指导 |
+| **OpenAI** | playwright | 浏览器自动化与 UI 流程调试 |
+| **Superpowers** | systematic-debugging, verification-before-completion, receiving-code-review, writing-skills, using-git-worktrees, writing-plans | 精选代码库工作流技能，不默认启用 TDD 或子代理执行重流程 |
+
+## 项目结构
+
+```
+~/.moluoxixi/
+├── rules/
+│   └── AGENTS.md          # 仓库级运行规则
+├── skills/                  # 第一方 skills（你的核心资产）
+│   ├── skill-validation-standard/
+│   └── workflow/
+│       ├── software-development-workflow/
+│       ├── frontend-code-standard/
+│       ├── node-code-standard/
+│       ├── nestjs-code-standard/
+│       └── java-code-standard/
+├── vendor/
+│   ├── repos/               # 克隆的第三方源仓库
+│   └── skills/              # 展平后的提取 skills
+├── constants/skills.ts      # 唯一的第三方技能配置清单
+├── scripts/                 # 安装/同步/校验脚本
+└── tests/                   # 自动化验证测试
+```
+
+> 源 `skills/` 目录允许递归分组；安装后的 vendor 与宿主 skills 目录统一按叶子 skill 名称展平。
+
+## 为什么不是另一个 AI Rules 集合？
+
+市面上已经有很多 AI rules 仓库。AIRules 不同的地方在于：
+
+| 其他方案 | AIRules |
+|---------|---------|
+| 一个大的 rules 文件 | 模块化的小 skill 单元 |
+| 手动复制粘贴 | 脚本驱动的自动分发 |
+| 只支持一种代理 | 同时支持 7 种 AI 代理 |
+| 全部自己写 | 克隆成熟的 + 自己写独特的 |
+| 一次性配置 | 持续同步 + 自愈修复 |
+
+## 许可证
+
+MIT

package/README.md

@@ -0,0 +1,246 @@
+# Moluoxixi AIRules
+
+> 🧩 Build your own AI coding best practices by composing modular skills — like LEGO bricks.
+
+**English** | **[中文](README-zh.md)**
+
+## What is this?
+
+AIRules is a **composable AI skill distribution system**. The core idea is simple:
+
+- **Clone** mature AI Skills from the community (antfu, Anthropic, Google Gemini, Vercel, etc.)
+- **Write** your own domain-specific Skills
+- **Compose** these small, modular units into your personalized development best practices
+- **Distribute** them to all your AI agents (Claude, Cursor, Codex, Gemini, etc.) with one command
+
+## Core Philosophy
+
+### 🏗️ Three-Layer Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│  🔧 First-Party Skills (your own)           │ ← Your competitive edge
+│  software-development-workflow / standards   │
+├─────────────────────────────────────────────┤
+│  📦 Third-Party Skills (cloned from mature  │ ← Stand on the shoulders
+│  repos) antfu/vue · anthropic/design · ... │   of giants
+├─────────────────────────────────────────────┤
+│  🚀 Distribution Engine (one-command deploy │ ← Automated infrastructure
+│  to all AI agents)                          │
+└─────────────────────────────────────────────┘
+```
+
+### 📐 Design Principles
+
+| Principle | Description |
+|-----------|-------------|
+| **Small, Modular Units** | Each skill does one thing — independent, testable, replaceable |
+| **Composition > Monolith** | Like Unix pipes — combine small tools to solve big problems |
+| **Third-Party First** | Use mature community skills; only write what's uniquely yours |
+| **Self-Healing Distribution** | One command syncs to all agents with auto link repair and verification |
+
+## What You Get
+
+- 🔥 **25+ curated** frontend/backend/general AI Skills out of the box
+- 🧱 **Reserved first-party expansion slots** so you can add your own top-level skills later without changing the distribution model
+- 🌐 **Multi-agent sync**: configure once, works across Claude / Cursor / Codex / Qoder / Tare / OpenCode / CC-Switch
+- 🔄 **Continuous updates**: one command pulls latest upstream skills
+
+## Installation
+
+**Use as a Node CLI (local development / npm link):**
+
+```bash
+npm install
+npm run build
+npm link
+airules sync --host all
+```
+
+Add a local skill and sync it to every host:
+
+```bash
+airules add ./my-skill --host all
+```
+
+The `add` command requires the source directory to contain `SKILL.md`. It copies the skill to `~/.moluoxixi/skills/<skill-name>` and then uses the same vendor/host projection pipeline.
+
+**macOS / Linux / Git Bash:**
+
+```bash
+git clone https://github.com/moluoxixi/AIRules.git "$HOME/.moluoxixi"
+cd "$HOME/.moluoxixi"
+npm run sync
+```
+
+**Windows CMD:**
+
+```cmd
+git clone https://github.com/moluoxixi/AIRules.git "%USERPROFILE%\.moluoxixi"
+cd "%USERPROFILE%\.moluoxixi"
+npm run sync
+```
+
+**Windows PowerShell:**
+
+```powershell
+git clone https://github.com/moluoxixi/AIRules.git "$env:USERPROFILE\.moluoxixi"
+cd "$env:USERPROFILE\.moluoxixi"
+npm run sync
+```
+
+> [!TIP]
+> **Sync Process**: This command rebuilds vendor skills, cleans dead links, and runs host verification after projection. Use `airules sync --skip-vendors` when you do not want to refresh third-party vendor repositories.
+
+---
+
+## Publishing
+
+Publishing is handled by `.github/workflows/publish.yml`.
+
+1. Create an npm automation token with publish permission and save it as the GitHub Actions repository secret `NPM_TOKEN`.
+2. Bump `package.json` to the version you want to publish, then push a matching Git tag such as `v0.1.0`.
+3. The pushed tag publishes automatically; you can also manually run the `Publish package` workflow with an existing tag name.
+4. The workflow installs dependencies, verifies the tag matches `package.json`, runs lint/typecheck/tests, and publishes with `npm publish --provenance --access public`.
+
+The workflow uses `npm install` because this repository intentionally does not track lockfiles.
+
+---
+
+## Specific Host Installation
+
+**macOS / Linux / Git Bash:**
+
+```bash
+git clone https://github.com/moluoxixi/AIRules.git "$HOME/.moluoxixi"
+cd "$HOME/.moluoxixi"
+npm run rules:install -- --host <host-name> (e.g., claude)
+```
+
+**Windows CMD:**
+
+```cmd
+git clone https://github.com/moluoxixi/AIRules.git "%USERPROFILE%\.moluoxixi"
+cd "%USERPROFILE%\.moluoxixi"
+npm run rules:install -- --host <host-name> (e.g., claude)
+```
+
+**Windows PowerShell:**
+
+```powershell
+git clone https://github.com/moluoxixi/AIRules.git "$env:USERPROFILE\.moluoxixi"
+cd "$env:USERPROFILE\.moluoxixi"
+npm run rules:install -- --host <host-name> (e.g., claude)
+```
+
+> [!TIP]
+> Inside the cloned repository, `npm run rules:install -- --host claude` still works and now forwards to `airules sync`.
+
+---
+
+## CLI Commands
+
+| Command | Purpose |
+|---------|---------|
+| `airules sync --host all` | Sync built-in, user-defined, and third-party skills to every existing host |
+| `airules add ./my-skill --host all` | Add a local skill and sync it to every host |
+| `airules add ./my-skill --name review-plus --overwrite` | Set the installed skill name and replace an existing user skill |
+| `airules verify --host codex` | Verify skill links for one host |
+
+Common options:
+
+| Option | Description |
+|--------|-------------|
+| `--home <dir>` | AIRules install directory, defaults to `~/.moluoxixi` |
+| `--user-home <dir>` | User home used for host directories, defaults to the current OS home |
+| `--host <name\|all>` | Target host, defaults to `all` |
+| `--skip-vendors` | Do not refresh third-party vendor repos during `sync` |
+| `--skip-sync` | Add the user skill without projecting it immediately |
+| `--no-verify` | Skip host verification |
+
+---
+
+### Agent Support Matrix
+
+Moluoxixi AIRules supports a growing ecosystem of AI agents through automated projection:
+
+| Agent | `--host` Value | Host Path | Projection Method | Baseline File |
+|-------|----------------|-----------|-------------------|---------------|
+| **Claude Code** | `claude` | `~/.claude/` | Symlink | `CLAUDE.md` |
+| **Codex** | `codex` | `~/.codex/` | Symlink | `AGENTS.md` |
+| **Cursor** | `cursor` | `~/.cursor/` | Symlink | `AGENTS.md` |
+| **Tare** | `tare` | `~/.tare/` | Symlink | `AGENTS.md` |
+| **OpenCode** | `opencode` | `~/.config/opencode/` | Symlink | `AGENTS.md` |
+| **CC-Switch** | `cc-switch` | `~/.cc-switch/` | Symlink | `AGENTS.md` |
+
+> [!NOTE]
+> All skills are automatically projected into the agent's dedicated skills directory during installation.
+
+---
+
+## Skills Overview
+
+### First-Party Skills (Custom)
+
+| Name | Description |
+|------|-------------|
+| **software-development-workflow** | Standard software development workflow for requirements, splitting, design, implementation, verification, review, and delivery reports |
+| **frontend-code-standard** | Vue 3 and React TypeScript/JavaScript frontend code standards for components, modules, utility libraries, UI component libraries, review output, and delivery checks |
+| **node-code-standard** | Node.js backend implementation standards for TypeScript/JavaScript services with explicit contracts, runtime validation, dependency injection, transaction boundaries, persistence encapsulation, and delivery checks |
+| **nestjs-code-standard** | NestJS backend implementation and review standards for new code, rewrites, and code reviews with DTO contracts, ValidationPipe, constructor injection, transaction boundaries, persistence encapsulation, and evidence-based review output |
+| **java-code-standard** | Java and Spring Boot backend code standards for Java 17+ baseline, Java 21/25 LTS, Maven, and Gradle with domain packages, constructor injection, Bean Validation, transaction boundaries, migrations, and error mapping |
+| **skill-validation-standard** | Minimal skill validation standard for generated or modified Claude/Codex skills, covering SKILL.md YAML frontmatter, folder-name matching, and line-count limits |
+
+> Workflow standards may live under nested source folders such as `skills/workflow`, but installation flattens them into `vendor/skills/<skill-name>`. First-party rules live in `rules/AGENTS.md`.
+
+### Third-Party Skills (Curated)
+
+| Source | Skills | Description |
+|--------|--------|-------------|
+| **antfu** | vue, nuxt, pinia, vite, vitest, unocss, pnpm, vitepress, slidev, tsdown, turborepo + 4 more | Vue ecosystem + frontend toolchain best practices |
+| **Google Gemini** | code-reviewer, pr-creator | Automated code review and PR creation |
+| **Vercel Labs** | find-skills | Open ecosystem skill discovery and installation |
+| **Vercel Agent Skills** | react-best-practices, react-native-skills, web-design-guidelines | React/React Native implementation guidance and Web UI review |
+| **Anthropic** | frontend-design | Production-grade frontend visual design guidance |
+| **OpenAI** | playwright | Browser automation and UI-flow debugging |
+| **Superpowers** | systematic-debugging, verification-before-completion, receiving-code-review, writing-skills, using-git-worktrees, writing-plans | Selected codebase workflow skills without default TDD or subagent execution |
+
+## Project Structure
+
+```
+~/.moluoxixi/
+├── rules/
+│   └── AGENTS.md          # Repository-level operating rules
+├── skills/                  # First-party skills (your core assets)
+│   ├── skill-validation-standard/
+│   └── workflow/
+│       ├── software-development-workflow/
+│       ├── frontend-code-standard/
+│       ├── node-code-standard/
+│       ├── nestjs-code-standard/
+│       └── java-code-standard/
+├── vendor/
+│   ├── repos/               # Cloned third-party source repos
+│   └── skills/              # Flattened extracted skills
+├── constants/skills.ts      # Single source of truth for vendor config
+├── scripts/                 # Install / sync / verify scripts
+└── tests/                   # Automated verification tests
+```
+
+> Source `skills/` folders may be grouped recursively; installed vendor and host skill directories are flattened by leaf skill name.
+
+## Why Not Just Another AI Rules Repo?
+
+There are many AI rules repositories out there. Here's what makes AIRules different:
+
+| Other Approaches | AIRules |
+|-----------------|---------|
+| One large rules file | Modular, composable skill units |
+| Manual copy-paste | Script-driven automated distribution |
+| Single agent support | 7 AI agents supported simultaneously |
+| Everything custom-written | Clone mature skills + write only what's unique |
+| One-time setup | Continuous sync + self-healing repair |
+
+## License
+
+MIT

package/dist/constants/hosts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 单个宿主（AI 代理）的配置定义
+ */
+export interface HostConfig {
+    /** 宿主标识符，也是 --host 参数的值 */
+    id: string;
+    /** 宿主的主目录（相对于 userHome 的路径片段） */
+    homeRelPath: string;
+    /** 宿主基线文件的文件名（如 CLAUDE.md / AGENTS.md） */
+    baselineFileName: string;
+    /** 宿主内 skills 目录的名字（默认 'skills'） */
+    skillsDirName?: string;
+}
+/**
+ * 所有支持的宿主（AI 代理）配置表
+ *
+ * 新增宿主时只需在此添加一条记录，脚本会自动感知。
+ */
+export declare const HOST_CONFIGS: HostConfig[];
+/** 所有支持的宿主 ID 列表，供 --host all 使用 */
+export declare const ALL_HOST_IDS: string[];
+/**
+ * 根据宿主 ID 获取配置，找不到时返回 undefined
+ */
+export declare function findHostConfig(id: string): HostConfig | undefined;
+/**
+ * 根据宿主配置和用户 home 目录，解析出完整的绝对路径集合
+ */
+export interface ResolvedHostPaths {
+    hostHome: string;
+    hostBaselineFile: string;
+    skillsDirName: string;
+}
+export declare function resolveHostPaths(config: HostConfig, userHome: string): ResolvedHostPaths;

package/dist/constants/hosts.js

@@ -0,0 +1,71 @@
+import path from 'node:path';
+/**
+ * 所有支持的宿主（AI 代理）配置表
+ *
+ * 新增宿主时只需在此添加一条记录，脚本会自动感知。
+ */
+export const HOST_CONFIGS = [
+    {
+        id: 'claude',
+        homeRelPath: '.claude',
+        baselineFileName: 'CLAUDE.md',
+    },
+    {
+        id: 'codex',
+        homeRelPath: '.codex',
+        baselineFileName: 'AGENTS.md',
+    },
+    {
+        id: 'cursor',
+        homeRelPath: '.cursor',
+        baselineFileName: 'AGENTS.md',
+        skillsDirName: 'skills-cursor',
+    },
+    // 不需要，会自己复用.agents
+    // {
+    //   id: 'qoder',
+    //   homeRelPath: '.qoder',
+    //   baselineFileName: 'AGENTS.md',
+    // },
+    {
+        id: 'qoderwork',
+        homeRelPath: '.qoderwork',
+        baselineFileName: 'AGENTS.md',
+    },
+    {
+        id: 'trae',
+        homeRelPath: '.trae',
+        baselineFileName: 'AGENTS.md',
+    },
+    {
+        id: 'trae-cn',
+        homeRelPath: '.trae-cn',
+        baselineFileName: 'AGENTS.md',
+    },
+    {
+        id: 'opencode',
+        homeRelPath: path.join('.config', 'opencode'),
+        baselineFileName: 'AGENTS.md',
+    },
+    {
+        id: 'cc-switch',
+        homeRelPath: '.cc-switch',
+        baselineFileName: 'AGENTS.md',
+    },
+];
+/** 所有支持的宿主 ID 列表，供 --host all 使用 */
+export const ALL_HOST_IDS = HOST_CONFIGS.map(h => h.id);
+/**
+ * 根据宿主 ID 获取配置，找不到时返回 undefined
+ */
+export function findHostConfig(id) {
+    return HOST_CONFIGS.find(h => h.id === id);
+}
+export function resolveHostPaths(config, userHome) {
+    const hostHome = path.join(userHome, ...config.homeRelPath.split(path.sep));
+    return {
+        hostHome,
+        hostBaselineFile: path.join(hostHome, config.baselineFileName),
+        skillsDirName: config.skillsDirName ?? 'skills',
+    };
+}