issuekit 0.1.5__tar.gz → 0.1.6__tar.gz

{issuekit-0.1.5 → issuekit-0.1.6}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-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.
+MIT License
+
+Copyright (c) 2026
+
+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.

{issuekit-0.1.5 → issuekit-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: issuekit
-Version: 0.1.5
+Version: 0.1.6
 Summary: AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。
 Project-URL: Homepage, https://github.com/xsg22/issue-kit
 Project-URL: Repository, https://github.com/xsg22/issue-kit
@@ -44,9 +44,10 @@ IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组 Skills
 | 4. 测试方案 | `$issuekit-test`    | 黑盒业务测试 + 白盒单测/接口测试用例   |
 | 5. 发布准备 | `$issuekit-release` | 生成发布文档，创建 Pull Request |
 | 6. 代码审核 | `$issuekit-review`  | 多维度交叉验证（需求、方案、质量）      |
+| 7. 代码合并 | `$issuekit-merge` | 理解改动背景，保全各分支有效能力，以门禁保障合并结果 |
 
 
-还有一个 `$issuekit-knowledge` skill，用于生成项目上下文摘要，让 AI 助手快速理解项目。
+另有 `$issuekit-knowledge` 生成项目上下文摘要、`$issuekit-change` 管理需求与方案变更，以及 `$issuekit-business-test` 设计并编排真实业务验收，共 10 个 Skill。
 
 ## 安装
 
@@ -116,6 +117,7 @@ AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校
 $issuekit-test      # 生成测试方案
 $issuekit-release   # 生成发布文档 + 创建 PR
 $issuekit-review    # 多维度代码审核
+$issuekit-merge     # 保全各分支有效能力，完成代码集成
 ```
 
 ## `init` 做了什么
@@ -130,7 +132,7 @@ $issuekit-review    # 多维度代码审核
   - Codex → `.agents/skills/`
   - GitHub Copilot → `.github/skills/`
 
-每个 Skill 包含 `SKILL.md`（指令）和 `agents/openai.yaml`（元数据）。
+每个 Skill 包含 `SKILL.md`（指令），并按需携带 `references/`、`scripts/` 和 `assets/`；Codex 还会安装 `agents/openai.yaml` 元数据。
 
 ## 更新模板与 Skills（已 init 的项目）
 
@@ -201,4 +203,4 @@ issues/                       # Issue 文档（默认目录，可通过 --issues
 
 ## 许可证
 
-MIT
+MIT

{issuekit-0.1.5 → issuekit-0.1.6}/README.md

@@ -15,9 +15,10 @@ IssueKit 为 AI 辅助开发提供结构化的工作流。它提供一组 Skills
 | 4. 测试方案 | `$issuekit-test`    | 黑盒业务测试 + 白盒单测/接口测试用例   |
 | 5. 发布准备 | `$issuekit-release` | 生成发布文档，创建 Pull Request |
 | 6. 代码审核 | `$issuekit-review`  | 多维度交叉验证（需求、方案、质量）      |
+| 7. 代码合并 | `$issuekit-merge` | 理解改动背景，保全各分支有效能力，以门禁保障合并结果 |
 
 
-还有一个 `$issuekit-knowledge` skill，用于生成项目上下文摘要，让 AI 助手快速理解项目。
+另有 `$issuekit-knowledge` 生成项目上下文摘要、`$issuekit-change` 管理需求与方案变更，以及 `$issuekit-business-test` 设计并编排真实业务验收，共 10 个 Skill。
 
 ## 安装
 
@@ -87,6 +88,7 @@ AI 助手按技术文档的开发步骤逐步实现，完成后自动交叉校
 $issuekit-test      # 生成测试方案
 $issuekit-release   # 生成发布文档 + 创建 PR
 $issuekit-review    # 多维度代码审核
+$issuekit-merge     # 保全各分支有效能力，完成代码集成
 ```
 
 ## `init` 做了什么
@@ -101,7 +103,7 @@ $issuekit-review    # 多维度代码审核
   - Codex → `.agents/skills/`
   - GitHub Copilot → `.github/skills/`
 
-每个 Skill 包含 `SKILL.md`（指令）和 `agents/openai.yaml`（元数据）。
+每个 Skill 包含 `SKILL.md`（指令），并按需携带 `references/`、`scripts/` 和 `assets/`；Codex 还会安装 `agents/openai.yaml` 元数据。
 
 ## 更新模板与 Skills（已 init 的项目）
 
@@ -172,4 +174,4 @@ issues/                       # Issue 文档（默认目录，可通过 --issues
 
 ## 许可证
 
-MIT
+MIT

{issuekit-0.1.5 → issuekit-0.1.6}/pyproject.toml

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

{issuekit-0.1.5 → issuekit-0.1.6}/scripts/release.sh

@@ -1,168 +1,168 @@
-#!/usr/bin/env bash
-# PyPI 发布（纯 shell，不依赖额外 Python 发布脚本）
-#
-# 依赖：pip install -e ".[release]" ；凭据见 ~/.pypirc 或 TWINE_* 环境变量
-#
-# 用法：
-#   ./scripts/release.sh patch|minor|major   # 升版并发布
-#   ./scripts/release.sh --set 1.0.0         # 指定版本并发布
-#   ./scripts/release.sh                     # 不升版，按当前版本构建并上传
-#   ./scripts/release.sh patch --dry-run --repository testpypi
-#
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-cd "$ROOT"
-
-PYPROJECT="$ROOT/pyproject.toml"
-INIT_PY="$ROOT/src/issuekit/__init__.py"
-
-usage() {
-  cat <<'EOF'
-PyPI 发布：./scripts/release.sh [patch|minor|major] [选项]
-
-选项：
-  --set VERSION        指定版本（x.y.z）
-  --repository NAME    pypi（默认）或 testpypi
-  --skip-tests         跳过 pytest
-  --dry-run            构建并检查，不上传
-  -h, --help           显示本说明
-EOF
-}
-
-read_pyproject_version() {
-  grep -E '^version[[:space:]]*=' "$PYPROJECT" | head -1 \
-    | sed -E 's/^version[[:space:]]*=[[:space:]]*"([^"]*)".*/\1/'
-}
-
-write_versions() {
-  local v="$1"
-  local tmp
-  tmp="$(mktemp)"
-  sed "s/^version = \".*\"/version = \"${v}\"/" "$PYPROJECT" >"$tmp" && mv "$tmp" "$PYPROJECT"
-  tmp="$(mktemp)"
-  sed "s/^__version__[[:space:]]*=[[:space:]]*\".*\"/__version__ = \"${v}\"/" "$INIT_PY" >"$tmp" && mv "$tmp" "$INIT_PY"
-}
-
-bump_semver() {
-  local ver="$1" kind="$2"
-  local major minor patch
-  if [[ ! "$ver" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-    echo "无法自动升版（仅支持纯 x.y.z，请用 --set）：$ver" >&2
-    exit 1
-  fi
-  IFS='.' read -r major minor patch <<<"$ver"
-  case "$kind" in
-    patch) patch=$((patch + 1)) ;;
-    minor) minor=$((minor + 1)); patch=0 ;;
-    major) major=$((major + 1)); minor=0; patch=0 ;;
-    *) echo "invalid bump: $kind" >&2; exit 1 ;;
-  esac
-  echo "${major}.${minor}.${patch}"
-}
-
-BUMP=""
-SET_VERSION=""
-REPOSITORY="pypi"
-SKIP_TESTS=0
-DRY_RUN=0
-
-# 首参 patch|minor|major 快捷方式
-if [[ "${1:-}" =~ ^(patch|minor|major)$ ]]; then
-  BUMP="$1"
-  shift
-fi
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --set)
-      SET_VERSION="${2:?--set 需要版本号}"
-      shift 2
-      ;;
-    --repository)
-      REPOSITORY="${2:?--repository 需要 pypi 或 testpypi}"
-      shift 2
-      ;;
-    --skip-tests) SKIP_TESTS=1; shift ;;
-    --dry-run) DRY_RUN=1; shift ;;
-    -h|--help) usage; exit 0 ;;
-    *)
-      echo "未知参数: $1" >&2
-      usage >&2
-      exit 1
-      ;;
-  esac
-done
-
-if [[ -n "$BUMP" && -n "$SET_VERSION" ]]; then
-  echo "不要同时使用升版档位与 --set" >&2
-  exit 1
-fi
-
-CURRENT="$(read_pyproject_version)"
-NEW_VERSION=""
-
-if [[ -n "$BUMP" ]]; then
-  NEW_VERSION="$(bump_semver "$CURRENT" "$BUMP")"
-elif [[ -n "$SET_VERSION" ]]; then
-  if [[ ! "$SET_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-    echo "--set 仅支持 x.y.z 格式: $SET_VERSION" >&2
-    exit 1
-  fi
-  NEW_VERSION="$SET_VERSION"
-fi
-
-if [[ -n "$NEW_VERSION" ]]; then
-  write_versions "$NEW_VERSION"
-  echo "Version: ${CURRENT} -> ${NEW_VERSION}"
-else
-  echo "Version: ${CURRENT} (unchanged)"
-fi
-
-if [[ "$SKIP_TESTS" -eq 0 ]]; then
-  if ! python -c "import pytest" 2>/dev/null; then
-    echo "未检测到 pytest，正在安装发布依赖: pip install -e \".[release]\""
-    python -m pip install -q -e ".[release]"
-  fi
-  echo "+ python -m pytest"
-  # 退出码 5 = 未收集到测试（旧版 pytest 或未开 suppress_no_test_exit_code 时仍视为可继续发布）
-  set +e
-  python -m pytest
-  pytest_ec=$?
-  set -e
-  if [[ "$pytest_ec" -ne 0 && "$pytest_ec" -ne 5 ]]; then
-    exit "$pytest_ec"
-  fi
-  if [[ "$pytest_ec" -eq 5 ]]; then
-    echo "提示: pytest 未收集到任何测试（退出码 5），继续构建与上传。" >&2
-  fi
-fi
-
-echo "+ clean dist/build artifacts"
-rm -rf dist build ./*.egg-info src/issuekit.egg-info 2>/dev/null || true
-
-echo "+ python -m build"
-python -m build
-
-echo "+ twine check dist/*"
-python -m twine check dist/*
-
-# 使用 -r pypi|testpypi（勿用 --repository-url），Twine 才会按名称读取 ~/.pypirc 里对应段落及凭据
-if [[ "$REPOSITORY" == "testpypi" ]]; then
-  TWINE_REPO=( -r testpypi )
-else
-  TWINE_REPO=( -r pypi )
-fi
-
-VER_FOR_MSG="${NEW_VERSION:-$CURRENT}"
-if [[ "$DRY_RUN" -eq 1 ]]; then
-  echo "+ (dry-run) skipping: python -m twine upload ${TWINE_REPO[*]} dist/*"
-  echo "Done (dry-run)."
-  exit 0
-fi
-
-echo "+ python -m twine upload ${TWINE_REPO[*]} dist/*"
-python -m twine upload "${TWINE_REPO[@]}" dist/*
-
-echo "Uploaded to ${REPOSITORY}. Verify: pip install issuekit==${VER_FOR_MSG}"
+#!/usr/bin/env bash
+# PyPI 发布（纯 shell，不依赖额外 Python 发布脚本）
+#
+# 依赖：pip install -e ".[release]" ；凭据见 ~/.pypirc 或 TWINE_* 环境变量
+#
+# 用法：
+#   ./scripts/release.sh patch|minor|major   # 升版并发布
+#   ./scripts/release.sh --set 1.0.0         # 指定版本并发布
+#   ./scripts/release.sh                     # 不升版，按当前版本构建并上传
+#   ./scripts/release.sh patch --dry-run --repository testpypi
+#
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$ROOT"
+
+PYPROJECT="$ROOT/pyproject.toml"
+INIT_PY="$ROOT/src/issuekit/__init__.py"
+
+usage() {
+  cat <<'EOF'
+PyPI 发布：./scripts/release.sh [patch|minor|major] [选项]
+
+选项：
+  --set VERSION        指定版本（x.y.z）
+  --repository NAME    pypi（默认）或 testpypi
+  --skip-tests         跳过 pytest
+  --dry-run            构建并检查，不上传
+  -h, --help           显示本说明
+EOF
+}
+
+read_pyproject_version() {
+  grep -E '^version[[:space:]]*=' "$PYPROJECT" | head -1 \
+    | sed -E 's/^version[[:space:]]*=[[:space:]]*"([^"]*)".*/\1/'
+}
+
+write_versions() {
+  local v="$1"
+  local tmp
+  tmp="$(mktemp)"
+  sed "s/^version = \".*\"/version = \"${v}\"/" "$PYPROJECT" >"$tmp" && mv "$tmp" "$PYPROJECT"
+  tmp="$(mktemp)"
+  sed "s/^__version__[[:space:]]*=[[:space:]]*\".*\"/__version__ = \"${v}\"/" "$INIT_PY" >"$tmp" && mv "$tmp" "$INIT_PY"
+}
+
+bump_semver() {
+  local ver="$1" kind="$2"
+  local major minor patch
+  if [[ ! "$ver" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    echo "无法自动升版（仅支持纯 x.y.z，请用 --set）：$ver" >&2
+    exit 1
+  fi
+  IFS='.' read -r major minor patch <<<"$ver"
+  case "$kind" in
+    patch) patch=$((patch + 1)) ;;
+    minor) minor=$((minor + 1)); patch=0 ;;
+    major) major=$((major + 1)); minor=0; patch=0 ;;
+    *) echo "invalid bump: $kind" >&2; exit 1 ;;
+  esac
+  echo "${major}.${minor}.${patch}"
+}
+
+BUMP=""
+SET_VERSION=""
+REPOSITORY="pypi"
+SKIP_TESTS=0
+DRY_RUN=0
+
+# 首参 patch|minor|major 快捷方式
+if [[ "${1:-}" =~ ^(patch|minor|major)$ ]]; then
+  BUMP="$1"
+  shift
+fi
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --set)
+      SET_VERSION="${2:?--set 需要版本号}"
+      shift 2
+      ;;
+    --repository)
+      REPOSITORY="${2:?--repository 需要 pypi 或 testpypi}"
+      shift 2
+      ;;
+    --skip-tests) SKIP_TESTS=1; shift ;;
+    --dry-run) DRY_RUN=1; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *)
+      echo "未知参数: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -n "$BUMP" && -n "$SET_VERSION" ]]; then
+  echo "不要同时使用升版档位与 --set" >&2
+  exit 1
+fi
+
+CURRENT="$(read_pyproject_version)"
+NEW_VERSION=""
+
+if [[ -n "$BUMP" ]]; then
+  NEW_VERSION="$(bump_semver "$CURRENT" "$BUMP")"
+elif [[ -n "$SET_VERSION" ]]; then
+  if [[ ! "$SET_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+    echo "--set 仅支持 x.y.z 格式: $SET_VERSION" >&2
+    exit 1
+  fi
+  NEW_VERSION="$SET_VERSION"
+fi
+
+if [[ -n "$NEW_VERSION" ]]; then
+  write_versions "$NEW_VERSION"
+  echo "Version: ${CURRENT} -> ${NEW_VERSION}"
+else
+  echo "Version: ${CURRENT} (unchanged)"
+fi
+
+if [[ "$SKIP_TESTS" -eq 0 ]]; then
+  if ! python -c "import pytest" 2>/dev/null; then
+    echo "未检测到 pytest，正在安装发布依赖: pip install -e \".[release]\""
+    python -m pip install -q -e ".[release]"
+  fi
+  echo "+ python -m pytest"
+  # 退出码 5 = 未收集到测试（旧版 pytest 或未开 suppress_no_test_exit_code 时仍视为可继续发布）
+  set +e
+  python -m pytest
+  pytest_ec=$?
+  set -e
+  if [[ "$pytest_ec" -ne 0 && "$pytest_ec" -ne 5 ]]; then
+    exit "$pytest_ec"
+  fi
+  if [[ "$pytest_ec" -eq 5 ]]; then
+    echo "提示: pytest 未收集到任何测试（退出码 5），继续构建与上传。" >&2
+  fi
+fi
+
+echo "+ clean dist/build artifacts"
+rm -rf dist build ./*.egg-info src/issuekit.egg-info 2>/dev/null || true
+
+echo "+ python -m build"
+python -m build
+
+echo "+ twine check dist/*"
+python -m twine check dist/*
+
+# 使用 -r pypi|testpypi（勿用 --repository-url），Twine 才会按名称读取 ~/.pypirc 里对应段落及凭据
+if [[ "$REPOSITORY" == "testpypi" ]]; then
+  TWINE_REPO=( -r testpypi )
+else
+  TWINE_REPO=( -r pypi )
+fi
+
+VER_FOR_MSG="${NEW_VERSION:-$CURRENT}"
+if [[ "$DRY_RUN" -eq 1 ]]; then
+  echo "+ (dry-run) skipping: python -m twine upload ${TWINE_REPO[*]} dist/*"
+  echo "Done (dry-run)."
+  exit 0
+fi
+
+echo "+ python -m twine upload ${TWINE_REPO[*]} dist/*"
+python -m twine upload "${TWINE_REPO[@]}" dist/*
+
+echo "Uploaded to ${REPOSITORY}. Verify: pip install issuekit==${VER_FOR_MSG}"

{issuekit-0.1.5 → issuekit-0.1.6}/src/issuekit/__init__.py

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

{issuekit-0.1.5 → issuekit-0.1.6}/src/issuekit/agent_skills.py

@@ -1,55 +1,73 @@
-"""将 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 skills 安装到目标目录。
+
+每个 skill 是一个独立目录，包含 SKILL.md。
+Codex 额外需要 agents/openai.yaml 元数据文件。
+源模板在 bundled_skills/ 下，包含入口、元数据及可选的引用文档和脚本。
+"""
+
+from importlib import resources
+from pathlib import Path
+
+SKILL_DIRS = [
+    "issuekit-require",
+    "issuekit-design",
+    "issuekit-coding",
+    "issuekit-test",
+    "issuekit-business-test",
+    "issuekit-release",
+    "issuekit-review",
+    "issuekit-merge",
+    "issuekit-change",
+    "issuekit-knowledge",
+]
+
+
+def _copy_skill_resources(source, destination: Path) -> None:
+    """递归复制包内 Skill 资源，兼容 importlib 的资源接口。"""
+    destination.mkdir(parents=True, exist_ok=True)
+    for item in source.iterdir():
+        target = destination / item.name
+        if item.is_dir():
+            _copy_skill_resources(item, target)
+        else:
+            target.write_bytes(item.read_bytes())
+
+
+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")
+
+        for resource_name in ("references", "scripts", "assets"):
+            resource_dir = source_dir / resource_name
+            if resource_dir.is_dir():
+                _copy_skill_resources(resource_dir, dest_dir / resource_name)
+
+        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.5 → issuekit-0.1.6}/src/issuekit/agents/__init__.py

@@ -1,5 +1,5 @@
-"""AI 助手适配层，支持不同编程助手的 Skills 安装。"""
-
-from .registry import AGENT_REGISTRY, get_agent_config
-
-__all__ = ["AGENT_REGISTRY", "get_agent_config"]
+"""AI 助手适配层，支持不同编程助手的 Skills 安装。"""
+
+from .registry import AGENT_REGISTRY, get_agent_config
+
+__all__ = ["AGENT_REGISTRY", "get_agent_config"]