issuekit 0.1.0__tar.gz → 0.1.2__tar.gz

{issuekit-0.1.0 → issuekit-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: issuekit
-Version: 0.1.0
+Version: 0.1.2
 Summary: AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。
 Project-URL: Homepage, https://github.com/xsg22/issue-kit
 Project-URL: Repository, https://github.com/xsg22/issue-kit
@@ -29,18 +29,20 @@ AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核
 
 ## IssueKit 是什么？
 
-IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组命令，引导你的 AI 编程助手（Cursor、Claude Code、Codex 等）完成一个 Issue 的完整生命周期：
+IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组 Skills，引导你的 AI 编程助手（Cursor、Claude Code、Codex 等）完成一个 Issue 的完整生命周期：
 
-| 阶段 | 命令 | 说明 |
-|------|------|------|
-| 1. 需求分析 | `/issuekit.require` | 分析需求，生成面向产品经理的需求文档 |
-| 2. 技术方案 | `/issuekit.design` | 架构设计、接口设计、组件设计、开发步骤 |
-| 3. 编码实现 | `/issuekit.coding` | 按技术方案编码，交叉校验代码与文档一致性 |
-| 4. 测试方案 | `/issuekit.test` | 黑盒业务测试 + 白盒单测/接口测试用例 |
-| 5. 发布准备 | `/issuekit.release` | 生成发布文档，创建 Pull Request |
-| 6. 代码审核 | `/issuekit.review` | 多维度交叉验证（需求、方案、质量） |
 
-还有一个 `/issuekit.knowledge` 命令，用于生成项目上下文摘要，让 AI 助手快速理解项目，无需每次从零扫描。
+| 阶段      | Skill               | 说明                     |
+| ------- | ------------------- | ---------------------- |
+| 1. 需求分析 | `$issuekit-require` | 分析需求，生成面向产品经理的需求文档     |
+| 2. 技术方案 | `$issuekit-design`  | 架构设计、接口设计、组件设计、开发步骤    |
+| 3. 编码实现 | `$issuekit-coding`  | 按技术方案编码，交叉校验代码与文档一致性   |
+| 4. 测试方案 | `$issuekit-test`    | 黑盒业务测试 + 白盒单测/接口测试用例   |
+| 5. 发布准备 | `$issuekit-release` | 生成发布文档，创建 Pull Request |
+| 6. 代码审核 | `$issuekit-review`  | 多维度交叉验证（需求、方案、质量）      |
+
+
+还有一个 `$issuekit-knowledge` skill，用于生成项目上下文摘要，让 AI 助手快速理解项目。
 
 ## 安装
 
@@ -56,10 +58,12 @@ pip install issuekit
 
 ```bash
 cd your-project
-issuekit init --ai cursor
+issuekit init --ai cursor     # Cursor
+issuekit init --ai codex      # Codex
+issuekit init --ai claude     # Claude Code
 ```
 
-这会创建 `.issuekit/` 目录（模板 + 知识库配置），并将命令文件安装到 `.cursor/commands/`。
+这会创建 `.issuekit/` 目录（模板 + 知识库配置），并将 Skills 安装到对应目录。
 
 默认 Issue 文档存放在项目根目录的 `issues/` 文件夹下。你也可以自定义目录：
 
@@ -69,10 +73,10 @@ issuekit init --ai cursor --issues-dir doc/issues
 
 ### 第 2 步：构建项目知识（可选但推荐）
 
-在 Cursor 中运行命令：
+在 AI 助手中运行：
 
 ```
-/issuekit.knowledge
+$issuekit-knowledge
 ```
 
 AI 助手会分析你的项目，生成结构化的知识摘要到 `.issuekit/knowledge/`。后续的需求分析和技术方案设计会自动读取这些摘要。
@@ -81,13 +85,8 @@ AI 助手会分析你的项目，生成结构化的知识摘要到 `.issuekit/kn
 
 假设产品经理给了一个需求："用户个人资料页面增加修改头像功能，支持裁剪和压缩"。
 
-在 Cursor 中运行：
+在 AI 助手中调用 `$issuekit-require`，AI 助手会：
 
-```
-/issuekit.require 用户个人资料页面增加修改头像功能，支持裁剪和压缩
-```
-
-AI 助手会：
 1. 深入分析代码，理解现有用户模块的实现
 2. 生成 Issue ID（如 `FEAT-20260228-avatar-upload`）
 3. 创建 `issues/FEAT-20260228-avatar-upload/requirement.md`
@@ -97,51 +96,48 @@ AI 助手会：
 
 ### 第 4 步：设计技术方案
 
-需求确认后，运行：
-
-```
-/issuekit.design
-```
+需求确认后，调用 `$issuekit-design`。
 
 生成 `technical-design.md`，涵盖技术调研、架构设计、核心流程、组件设计、接口设计、开发步骤。
 
 ### 第 5 步：编码实现
 
-```
-/issuekit.coding
-```
+调用 `$issuekit-coding`。
 
 AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校验代码与技术文档、需求文档的一致性。
 
 ### 第 6 步：后续流程
 
 ```
-/issuekit.test      # 生成测试方案
-/issuekit.release   # 生成发布文档 + 创建 PR
-/issuekit.review    # 多维度代码审核
+$issuekit-test      # 生成测试方案
+$issuekit-release   # 生成发布文档 + 创建 PR
+$issuekit-review    # 多维度代码审核
 ```
 
 ## `init` 做了什么
 
 1. 创建 `.issuekit/` 目录：
-   - `config.yaml` — 项目配置（Issue 文档目录等）
-   - `templates/` — 各阶段文档模板（需求、技术方案、测试、发布、审核）
-   - `knowledge/` — 项目上下文知识摘要（由 `/issuekit.knowledge` 生成）
+  - `config.yaml` — 项目配置（Issue 文档目录等）
+  - `templates/` — 各阶段文档模板（需求、技术方案、测试、发布、审核）
+  - `knowledge/` — 项目上下文知识摘要
+2. 安装 Skills 到对应目录：
+  - Cursor → `.cursor/skills/`
+  - Claude Code → `.claude/skills/`
+  - Codex → `.agents/skills/`
+  - GitHub Copilot → `.github/skills/`
 
-2. 安装 AI 助手命令到对应目录：
-   - Cursor → `.cursor/commands/`
-   - Claude Code → `.claude/commands/`
-   - Codex → `.codex/commands/`
-   - GitHub Copilot → `.github/agents/`
+每个 Skill 包含 `SKILL.md`（指令）和 `agents/openai.yaml`（元数据）。
 
 ## 支持的 AI 助手
 
-| AI 助手 | 参数 | 状态 |
-|---------|------|------|
-| Cursor | `--ai cursor` | 已支持 |
-| Claude Code | `--ai claude` | 已支持 |
-| Codex | `--ai codex` | 已支持 |
-| GitHub Copilot | `--ai copilot` | 已支持 |
+
+| AI 助手          | 参数             | Skills 目录         |
+| -------------- | -------------- | ----------------- |
+| Cursor         | `--ai cursor`  | `.cursor/skills/` |
+| Claude Code    | `--ai claude`  | `.claude/skills/` |
+| Codex          | `--ai codex`   | `.agents/skills/` |
+| GitHub Copilot | `--ai copilot` | `.github/skills/` |
+
 
 ## 目录结构
 
@@ -156,22 +152,29 @@ AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校
 │   └── code-review.md        # 代码审核模板
 └── knowledge/                # 项目上下文知识摘要
     ├── config.yaml           # 知识库配置
-    ├── project-overview.md   # 项目概览（/issuekit.knowledge 生成）
+    ├── project-overview.md   # 项目概览
     ├── architecture.md       # 架构分析
     ├── api-surface.md        # API 接口摘要
     ├── data-model.md         # 数据模型摘要
     ├── integrations.md       # 外部集成摘要
     └── conventions.md        # 编码约定摘要
 
+.cursor/skills/               # Cursor Skills（示例）
+├── issuekit-require/
+│   └── SKILL.md
+├── issuekit-design/
+│   └── SKILL.md
+└── ...
+
 issues/                       # Issue 文档（默认目录，可通过 --issues-dir 自定义）
 └── FEAT-20260228-xxx/
-    ├── requirement.md        # 需求文档
-    ├── technical-design.md   # 技术方案
-    ├── test-plan.md          # 测试方案
-    ├── release-note.md       # 发布文档
-    └── code-review.md        # 代码审核
+    ├── requirement.md
+    ├── technical-design.md
+    ├── test-plan.md
+    ├── release-note.md
+    └── code-review.md
 ```
 
 ## 许可证
 
-MIT
+MIT

{issuekit-0.1.0 → issuekit-0.1.2}/README.md

@@ -1,152 +1,155 @@
-# IssueKit
-
-AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。
-
-## IssueKit 是什么？
-
-IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组命令，引导你的 AI 编程助手（Cursor、Claude Code、Codex 等）完成一个 Issue 的完整生命周期：
-
-| 阶段 | 命令 | 说明 |
-|------|------|------|
-| 1. 需求分析 | `/issuekit.require` | 分析需求，生成面向产品经理的需求文档 |
-| 2. 技术方案 | `/issuekit.design` | 架构设计、接口设计、组件设计、开发步骤 |
-| 3. 编码实现 | `/issuekit.coding` | 按技术方案编码，交叉校验代码与文档一致性 |
-| 4. 测试方案 | `/issuekit.test` | 黑盒业务测试 + 白盒单测/接口测试用例 |
-| 5. 发布准备 | `/issuekit.release` | 生成发布文档，创建 Pull Request |
-| 6. 代码审核 | `/issuekit.review` | 多维度交叉验证（需求、方案、质量） |
-
-还有一个 `/issuekit.knowledge` 命令，用于生成项目上下文摘要，让 AI 助手快速理解项目，无需每次从零扫描。
-
-## 安装
-
-```bash
-pip install issuekit
-```
-
-## 快速上手
-
-### 第 1 步：初始化
-
-在你的项目根目录运行：
-
-```bash
-cd your-project
-issuekit init --ai cursor
-```
-
-这会创建 `.issuekit/` 目录（模板 + 知识库配置），并将命令文件安装到 `.cursor/commands/`。
-
-默认 Issue 文档存放在项目根目录的 `issues/` 文件夹下。你也可以自定义目录：
-
-```bash
-issuekit init --ai cursor --issues-dir doc/issues
-```
-
-### 第 2 步：构建项目知识（可选但推荐）
-
-在 Cursor 中运行命令：
-
-```
-/issuekit.knowledge
-```
-
-AI 助手会分析你的项目，生成结构化的知识摘要到 `.issuekit/knowledge/`。后续的需求分析和技术方案设计会自动读取这些摘要。
-
-### 第 3 步：创建第一个 Issue
-
-假设产品经理给了一个需求："用户个人资料页面增加修改头像功能，支持裁剪和压缩"。
-
-在 Cursor 中运行：
-
-```
-/issuekit.require 用户个人资料页面增加修改头像功能，支持裁剪和压缩
-```
-
-AI 助手会：
-1. 深入分析代码，理解现有用户模块的实现
-2. 生成 Issue ID（如 `FEAT-20260228-avatar-upload`）
-3. 创建 `issues/FEAT-20260228-avatar-upload/requirement.md`
-4. 从 master 拉出特性分支 `feature/FEAT-20260228-avatar-upload`
-
-需求文档包含：用户故事（Mermaid 流程图）、边界场景、验收标准、AI 需求评审、待确认问题。
-
-### 第 4 步：设计技术方案
-
-需求确认后，运行：
-
-```
-/issuekit.design
-```
-
-生成 `technical-design.md`，涵盖技术调研、架构设计、核心流程、组件设计、接口设计、开发步骤。
-
-### 第 5 步：编码实现
-
-```
-/issuekit.coding
-```
-
-AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校验代码与技术文档、需求文档的一致性。
-
-### 第 6 步：后续流程
-
-```
-/issuekit.test      # 生成测试方案
-/issuekit.release   # 生成发布文档 + 创建 PR
-/issuekit.review    # 多维度代码审核
-```
-
-## `init` 做了什么
-
-1. 创建 `.issuekit/` 目录：
-   - `config.yaml` — 项目配置（Issue 文档目录等）
-   - `templates/` — 各阶段文档模板（需求、技术方案、测试、发布、审核）
-   - `knowledge/` — 项目上下文知识摘要（由 `/issuekit.knowledge` 生成）
-
-2. 安装 AI 助手命令到对应目录：
-   - Cursor → `.cursor/commands/`
-   - Claude Code → `.claude/commands/`
-   - Codex → `.codex/commands/`
-   - GitHub Copilot → `.github/agents/`
-
-## 支持的 AI 助手
-
-| AI 助手 | 参数 | 状态 |
-|---------|------|------|
-| Cursor | `--ai cursor` | 已支持 |
-| Claude Code | `--ai claude` | 已支持 |
-| Codex | `--ai codex` | 已支持 |
-| GitHub Copilot | `--ai copilot` | 已支持 |
-
-## 目录结构
-
-```
-.issuekit/
-├── config.yaml               # 项目配置（issues_dir 等）
-├── templates/                # 文档模板
-│   ├── requirement.md        # 需求文档模板
-│   ├── technical-design.md   # 技术方案模板
-│   ├── test-plan.md          # 测试方案模板
-│   ├── release-note.md       # 发布文档模板
-│   └── code-review.md        # 代码审核模板
-└── knowledge/                # 项目上下文知识摘要
-    ├── config.yaml           # 知识库配置
-    ├── project-overview.md   # 项目概览（/issuekit.knowledge 生成）
-    ├── architecture.md       # 架构分析
-    ├── api-surface.md        # API 接口摘要
-    ├── data-model.md         # 数据模型摘要
-    ├── integrations.md       # 外部集成摘要
-    └── conventions.md        # 编码约定摘要
-
-issues/                       # Issue 文档（默认目录，可通过 --issues-dir 自定义）
-└── FEAT-20260228-xxx/
-    ├── requirement.md        # 需求文档
-    ├── technical-design.md   # 技术方案
-    ├── test-plan.md          # 测试方案
-    ├── release-note.md       # 发布文档
-    └── code-review.md        # 代码审核
-```
-
-## 许可证
-
-MIT
+# IssueKit
+
+AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。
+
+## IssueKit 是什么？
+
+IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组 Skills，引导你的 AI 编程助手（Cursor、Claude Code、Codex 等）完成一个 Issue 的完整生命周期：
+
+
+| 阶段      | Skill               | 说明                     |
+| ------- | ------------------- | ---------------------- |
+| 1. 需求分析 | `$issuekit-require` | 分析需求，生成面向产品经理的需求文档     |
+| 2. 技术方案 | `$issuekit-design`  | 架构设计、接口设计、组件设计、开发步骤    |
+| 3. 编码实现 | `$issuekit-coding`  | 按技术方案编码，交叉校验代码与文档一致性   |
+| 4. 测试方案 | `$issuekit-test`    | 黑盒业务测试 + 白盒单测/接口测试用例   |
+| 5. 发布准备 | `$issuekit-release` | 生成发布文档，创建 Pull Request |
+| 6. 代码审核 | `$issuekit-review`  | 多维度交叉验证（需求、方案、质量）      |
+
+
+还有一个 `$issuekit-knowledge` skill，用于生成项目上下文摘要，让 AI 助手快速理解项目。
+
+## 安装
+
+```bash
+pip install issuekit
+```
+
+## 快速上手
+
+### 第 1 步：初始化
+
+在你的项目根目录运行：
+
+```bash
+cd your-project
+issuekit init --ai cursor     # Cursor
+issuekit init --ai codex      # Codex
+issuekit init --ai claude     # Claude Code
+```
+
+这会创建 `.issuekit/` 目录（模板 + 知识库配置），并将 Skills 安装到对应目录。
+
+默认 Issue 文档存放在项目根目录的 `issues/` 文件夹下。你也可以自定义目录：
+
+```bash
+issuekit init --ai cursor --issues-dir doc/issues
+```
+
+### 第 2 步：构建项目知识（可选但推荐）
+
+在 AI 助手中运行：
+
+```
+$issuekit-knowledge
+```
+
+AI 助手会分析你的项目，生成结构化的知识摘要到 `.issuekit/knowledge/`。后续的需求分析和技术方案设计会自动读取这些摘要。
+
+### 第 3 步：创建第一个 Issue
+
+假设产品经理给了一个需求："用户个人资料页面增加修改头像功能，支持裁剪和压缩"。
+
+在 AI 助手中调用 `$issuekit-require`，AI 助手会：
+
+1. 深入分析代码，理解现有用户模块的实现
+2. 生成 Issue ID（如 `FEAT-20260228-avatar-upload`）
+3. 创建 `issues/FEAT-20260228-avatar-upload/requirement.md`
+4. 从 master 拉出特性分支 `feature/FEAT-20260228-avatar-upload`
+
+需求文档包含：用户故事（Mermaid 流程图）、边界场景、验收标准、AI 需求评审、待确认问题。
+
+### 第 4 步：设计技术方案
+
+需求确认后，调用 `$issuekit-design`。
+
+生成 `technical-design.md`，涵盖技术调研、架构设计、核心流程、组件设计、接口设计、开发步骤。
+
+### 第 5 步：编码实现
+
+调用 `$issuekit-coding`。
+
+AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校验代码与技术文档、需求文档的一致性。
+
+### 第 6 步：后续流程
+
+```
+$issuekit-test      # 生成测试方案
+$issuekit-release   # 生成发布文档 + 创建 PR
+$issuekit-review    # 多维度代码审核
+```
+
+## `init` 做了什么
+
+1. 创建 `.issuekit/` 目录：
+  - `config.yaml` — 项目配置（Issue 文档目录等）
+  - `templates/` — 各阶段文档模板（需求、技术方案、测试、发布、审核）
+  - `knowledge/` — 项目上下文知识摘要
+2. 安装 Skills 到对应目录：
+  - Cursor → `.cursor/skills/`
+  - Claude Code → `.claude/skills/`
+  - Codex → `.agents/skills/`
+  - GitHub Copilot → `.github/skills/`
+
+每个 Skill 包含 `SKILL.md`（指令）和 `agents/openai.yaml`（元数据）。
+
+## 支持的 AI 助手
+
+
+| AI 助手          | 参数             | Skills 目录         |
+| -------------- | -------------- | ----------------- |
+| Cursor         | `--ai cursor`  | `.cursor/skills/` |
+| Claude Code    | `--ai claude`  | `.claude/skills/` |
+| Codex          | `--ai codex`   | `.agents/skills/` |
+| GitHub Copilot | `--ai copilot` | `.github/skills/` |
+
+
+## 目录结构
+
+```
+.issuekit/
+├── config.yaml               # 项目配置（issues_dir 等）
+├── templates/                # 文档模板
+│   ├── requirement.md        # 需求文档模板
+│   ├── technical-design.md   # 技术方案模板
+│   ├── test-plan.md          # 测试方案模板
+│   ├── release-note.md       # 发布文档模板
+│   └── code-review.md        # 代码审核模板
+└── knowledge/                # 项目上下文知识摘要
+    ├── config.yaml           # 知识库配置
+    ├── project-overview.md   # 项目概览
+    ├── architecture.md       # 架构分析
+    ├── api-surface.md        # API 接口摘要
+    ├── data-model.md         # 数据模型摘要
+    ├── integrations.md       # 外部集成摘要
+    └── conventions.md        # 编码约定摘要
+
+.cursor/skills/               # Cursor Skills（示例）
+├── issuekit-require/
+│   └── SKILL.md
+├── issuekit-design/
+│   └── SKILL.md
+└── ...
+
+issues/                       # Issue 文档（默认目录，可通过 --issues-dir 自定义）
+└── FEAT-20260228-xxx/
+    ├── requirement.md
+    ├── technical-design.md
+    ├── test-plan.md
+    ├── release-note.md
+    └── code-review.md
+```
+
+## 许可证
+
+MIT

{issuekit-0.1.0 → issuekit-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "issuekit"
-version = "0.1.0"
+version = "0.1.2"
 description = "AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。"
 requires-python = ">=3.10"
 license = "MIT"

{issuekit-0.1.0 → issuekit-0.1.2}/src/issuekit/__init__.py

@@ -1,3 +1,3 @@
 """IssueKit - AI 辅助开发的 Issue 全生命周期工具。"""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

issuekit-0.1.2/src/issuekit/agent_skills.py

@@ -0,0 +1,55 @@
+"""将 issuekit skills 安装到目标目录。
+
+每个 skill 是一个独立目录，包含 SKILL.md。
+Codex 额外需要 agents/openai.yaml 元数据文件。
+源模板在 bundled_skills/ 下，按 skill-name/{SKILL.md, agents/openai.yaml} 组织。
+"""
+
+from importlib import resources
+from pathlib import Path
+
+SKILL_DIRS = [
+    "issuekit-require",
+    "issuekit-design",
+    "issuekit-coding",
+    "issuekit-test",
+    "issuekit-release",
+    "issuekit-review",
+    "issuekit-change",
+    "issuekit-knowledge",
+]
+
+
+def install_agent_skills(skills_dir: Path, *, include_openai_yaml: bool = False) -> int:
+    """将所有 bundled skills 安装到目标目录，返回安装数。
+
+    Args:
+        skills_dir: 目标 skills 目录。
+        include_openai_yaml: 是否同时复制 agents/openai.yaml（仅 Codex 需要）。
+    """
+    bundled = resources.files("issuekit") / "bundled_skills"
+    count = 0
+
+    for skill_name in SKILL_DIRS:
+        source_dir = bundled / skill_name
+        skill_md = source_dir / "SKILL.md"
+        if not skill_md.is_file():
+            continue
+
+        dest_dir = skills_dir / skill_name
+        dest_dir.mkdir(parents=True, exist_ok=True)
+
+        content = skill_md.read_text(encoding="utf-8")
+        (dest_dir / "SKILL.md").write_text(content, encoding="utf-8")
+
+        if include_openai_yaml:
+            openai_yaml = source_dir / "agents" / "openai.yaml"
+            if openai_yaml.is_file():
+                agents_dir = dest_dir / "agents"
+                agents_dir.mkdir(parents=True, exist_ok=True)
+                yaml_content = openai_yaml.read_text(encoding="utf-8")
+                (agents_dir / "openai.yaml").write_text(yaml_content, encoding="utf-8")
+
+        count += 1
+
+    return count

{issuekit-0.1.0 → issuekit-0.1.2}/src/issuekit/agents/__init__.py

@@ -1,4 +1,4 @@
-"""AI 助手适配层，支持不同编程助手的命令格式。"""
+"""AI 助手适配层，支持不同编程助手的 Skills 安装。"""
 
 from .registry import AGENT_REGISTRY, get_agent_config
 

issuekit-0.1.2/src/issuekit/agents/registry.py

@@ -0,0 +1,52 @@
+"""AI 助手配置注册表。
+
+每个助手定义了 Skills 的安装位置。
+"""
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class AgentConfig:
+    """AI 助手配置项。"""
+    name: str
+    skills_dir: str
+    """Skills 安装目录（每个 skill 一个子目录，含 SKILL.md）。"""
+    has_openai_yaml: bool = False
+    """是否安装 agents/openai.yaml 元数据（仅 Codex 需要）。"""
+
+    def format_description(self) -> str:
+        return f"{self.name} ({self.skills_dir})"
+
+
+AGENT_REGISTRY: dict[str, AgentConfig] = {
+    "cursor": AgentConfig(
+        name="Cursor",
+        skills_dir=".cursor/skills",
+    ),
+    "claude": AgentConfig(
+        name="Claude Code",
+        skills_dir=".claude/skills",
+    ),
+    "codex": AgentConfig(
+        name="Codex",
+        skills_dir=".agents/skills",
+        has_openai_yaml=True,
+    ),
+    "copilot": AgentConfig(
+        name="GitHub Copilot",
+        skills_dir=".github/skills",
+    ),
+}
+
+AGENT_ALIASES: dict[str, str] = {
+    "cursor-agent": "cursor",
+    "claude-code": "claude",
+}
+
+
+def get_agent_config(name: str) -> Optional[AgentConfig]:
+    """根据名称获取 AI 助手配置，支持别名解析。"""
+    resolved = AGENT_ALIASES.get(name, name)
+    return AGENT_REGISTRY.get(resolved)