issuekit 0.1.3__tar.gz → 0.1.4__tar.gz

{issuekit-0.1.3 → issuekit-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: issuekit
-Version: 0.1.3
+Version: 0.1.4
 Summary: AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。
 Project-URL: Homepage, https://github.com/xsg22/issue-kit
 Project-URL: Repository, https://github.com/xsg22/issue-kit
@@ -18,6 +18,10 @@ Requires-Dist: click>=8.1
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
 Requires-Dist: typer>=0.9
+Provides-Extra: release
+Requires-Dist: build>=1.0; extra == 'release'
+Requires-Dist: pytest>=7.0; extra == 'release'
+Requires-Dist: twine>=5.0; extra == 'release'
 Provides-Extra: test
 Requires-Dist: pytest-cov>=4.0; extra == 'test'
 Requires-Dist: pytest>=7.0; extra == 'test'

{issuekit-0.1.3 → issuekit-0.1.4}/pyproject.toml

@@ -1,46 +1,51 @@
-[project]
-name = "issuekit"
-version = "0.1.3"
-description = "AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。"
-requires-python = ">=3.10"
-license = "MIT"
-readme = "README.md"
-keywords = ["ai", "issue", "development", "cursor", "claude", "codex"]
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Topic :: Software Development :: Quality Assurance",
-]
-dependencies = [
-    "typer>=0.9",
-    "click>=8.1",
-    "rich>=13.0",
-    "pyyaml>=6.0",
-]
-
-[project.scripts]
-issuekit = "issuekit.cli:app"
-
-[project.urls]
-Homepage = "https://github.com/xsg22/issue-kit"
-Repository = "https://github.com/xsg22/issue-kit"
-Issues = "https://github.com/xsg22/issue-kit/issues"
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/issuekit"]
-
-[project.optional-dependencies]
-test = [
-    "pytest>=7.0",
-    "pytest-cov>=4.0",
-]
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-addopts = ["-v", "--tb=short"]
+[project]
+name = "issuekit"
+version = "0.1.4"
+description = "AI 辅助开发的 Issue 全生命周期工具。从需求分析到代码审核，由你的 AI 编程助手驱动。"
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+keywords = ["ai", "issue", "development", "cursor", "claude", "codex"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "typer>=0.9",
+    "click>=8.1",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+issuekit = "issuekit.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/xsg22/issue-kit"
+Repository = "https://github.com/xsg22/issue-kit"
+Issues = "https://github.com/xsg22/issue-kit/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/issuekit"]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+release = [
+    "build>=1.0",
+    "twine>=5.0",
+    "pytest>=7.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["-v", "--tb=short"]

issuekit-0.1.4/scripts/release.sh

@@ -0,0 +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}"

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/__init__.py

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

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-change/SKILL.md

@@ -13,6 +13,14 @@ description: 记录和管理 Issue 的需求或方案变更。追踪变更对所
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始变更分析规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与本次变更相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续变更步骤
+
 ### 第 1 步：定位 Issue 并解析变更
 
 1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-coding/SKILL.md

@@ -20,6 +20,14 @@ description: 按技术方案进行编码实现。逐步执行开发步骤，完
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始编码规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与当前改动相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续编码步骤
+
 ### 第 1 步：定位 Issue 并阅读上下文
 
 1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-design/SKILL.md

@@ -20,6 +20,14 @@ description: 为 Issue 设计技术方案。技术调研、架构设计、接口
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始方案规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与本次 issue 相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续设计步骤
+
 ### 第 1 步：定位 Issue
 
 1. 如果用户输入中包含 issue ID，直接使用

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-knowledge/SKILL.md

@@ -1,21 +1,43 @@
 ---
 name: issuekit-knowledge
-description: 分析当前项目，生成结构化的上下文知识摘要到 .issuekit/knowledge/，供其他 issuekit skill 使用。当用户提到构建知识库、项目知识摘要时使用。
+description: 分析当前项目，生成结构化的上下文知识摘要到 .issuekit/knowledge/；也支持按功能模块单独梳理并输出到 .issuekit/knowledge/modules/。供其他 issuekit skill 使用。当用户提到构建知识库、项目知识摘要时使用。
 ---
 
 ## 概述
 
 本 skill 分析当前项目的代码、配置和结构，生成一系列知识摘要文件。这些摘要让 AI Agent 在执行需求分析、技术方案设计等任务时，能快速理解项目上下文，而无需每次从零扫描。
 
-**输出目录**: `.issuekit/knowledge/`
+**输出目录**:
+- 全量知识：`.issuekit/knowledge/`
+- 模块知识：`.issuekit/knowledge/modules/`
+
+## 用户输入模式
+
+- 未指定模块时：执行全量知识梳理（默认）
+- 指定模块名称/路径/功能域时：仅梳理该模块及其直接依赖上下文，输出模块知识文件
 
 ## 工作流程
 
-### 第 1 步：检测项目类型
+### 第 0 步：先读取知识约定并规划任务
+
+在开始知识梳理规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 相关模块文件则优先阅读
+3. 基于现有约定与已有知识，规划本次是全量更新还是模块增量更新
+
+### 第 1 步：识别梳理范围并检测项目类型
+
+先识别本次任务是"全量知识梳理"还是"模块知识梳理"：
+
+1. 若用户明确指定模块（如"订单模块"、`src/order/`、"支付流程"），进入模块模式
+2. 否则进入全量模式
+3. 在开始分析前，先阅读已存在的 `.issuekit/knowledge/` 内容（如有），避免重复扫描和重复结论
+4. 然后自动识别项目技术栈和构建系统：
 
 自动识别项目的技术栈和构建系统：
 
-1. 扫描项目根目录的构建/配置文件：
+   - 扫描项目根目录的构建/配置文件：
    - `pom.xml` / `build.gradle` → Java/Kotlin
    - `package.json` → JavaScript/TypeScript
    - `go.mod` → Go
@@ -23,9 +45,9 @@ description: 分析当前项目，生成结构化的上下文知识摘要到 .is
    - `Cargo.toml` → Rust
    - `*.csproj` / `*.sln` → C#/.NET
    - 其他构建文件 → 按实际情况处理
-2. 读取依赖配置，提取所有依赖及版本
-3. 读取应用配置文件（如 application.yml, config/ 等）识别中间件和外部服务
-4. 忽略.env;.cursor;.idea等不可见的配置文件
+   - 读取依赖配置，提取所有依赖及版本
+   - 读取应用配置文件（如 application.yml, config/ 等）识别中间件和外部服务
+   - 忽略.env;.cursor;.idea等不可见的配置文件
 
 ### 第 2 步：项目概览
 
@@ -37,6 +59,8 @@ description: 分析当前项目，生成结构化的上下文知识摘要到 .is
 - 代码规模统计（按语言/模块的文件数和行数）
 - Git 活跃度（近 6 个月的提交频率、主要贡献者）
 
+如果是模块模式，跳过本步骤。
+
 ### 第 3 步：架构分析
 
 生成 `.issuekit/knowledge/architecture.md`：
@@ -87,6 +111,18 @@ description: 分析当前项目，生成结构化的上下文知识摘要到 .is
 - 日志使用方式
 - 错误处理模式
 - 如果项目已有规范文件（如 .cursor/rules/, .editorconfig, linter 配置），整合其内容
+- 增加"Agent 使用提示"小节：执行任何任务前，先阅读 `.issuekit/knowledge/` 中与任务相关的已有知识；若存在 `.issuekit/knowledge/modules/` 对应模块文件，优先阅读模块文件，再补充全局知识，然后再开始任务规划
+
+### 第 7.5 步：模块知识文件（仅模块模式）
+
+生成 `.issuekit/knowledge/modules/{module-name}.md`：
+
+- 模块边界（职责、入口、对外能力）
+- 核心流程（Mermaid flowchart/sequenceDiagram）
+- 模块 API 与关键数据结构
+- 依赖与被依赖关系（重点列出跨模块调用）
+- 约定与注意事项（从 `conventions.md` 抽取与模块强相关部分）
+- 已知风险和待确认点
 
 ### 第 8 步：报告完成
 
@@ -100,8 +136,10 @@ description: 分析当前项目，生成结构化的上下文知识摘要到 .is
 - .issuekit/knowledge/data-model.md
 - .issuekit/knowledge/integrations.md
 - .issuekit/knowledge/conventions.md
+（模块模式额外生成）
+- .issuekit/knowledge/modules/{module-name}.md
 
-后续 skill（如 $issuekit-require、$issuekit-design）将自动读取这些知识摘要。
+后续 skill（如 $issuekit-require、$issuekit-design）将优先读取这些知识摘要与模块知识（如存在）。
 ```
 
 ## AI 执行指南
@@ -112,6 +150,7 @@ description: 分析当前项目，生成结构化的上下文知识摘要到 .is
 - 如果某个步骤不适用（如项目无数据库），跳过并注明
 - 优先使用 Mermaid 图表，文字作为补充
 - 所有关键入口使用可点击的相对路径链接
+- 任何知识梳理前先复用已有知识文件，优先增量更新，避免重复产出
 
 ### 增量更新
 

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-release/SKILL.md

@@ -19,6 +19,14 @@ description: 准备发布文档并创建 Pull Request。分析代码变更，对
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始发布规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与本次发布内容相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续发布步骤
+
 ### 第 1 步：定位 Issue 并分析变更
 
 1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-require/SKILL.md

@@ -15,6 +15,14 @@ description: 创建新 Issue 并进行需求分析。结合代码分析需求完
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始需求分析规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与本次需求相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续步骤的任务规划与执行
+
 ### 第 1 步：解析需求输入
 
 1. 从用户输入提取需求描述

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-review/SKILL.md

@@ -18,6 +18,14 @@ description: 多维度代码审核。交叉验证代码变更与需求、技术
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始代码审核规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与当前审核范围相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续审核步骤
+
 ### 第 1 步：定位 Issue 并收集材料
 
 1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_skills/issuekit-test/SKILL.md

@@ -17,6 +17,14 @@ description: 为 Issue 制定全面的测试方案。基于需求和技术方案
 
 ## 工作流程
 
+### 第 0 步：先读取知识约定并规划任务
+
+在开始测试方案规划前，优先执行：
+
+1. 阅读 `.issuekit/knowledge/conventions.md`（如有）
+2. 阅读 `.issuekit/knowledge/` 下与当前测试范围相关的已有知识摘要（如有），若存在 `.issuekit/knowledge/modules/` 对应模块文件则优先阅读
+3. 基于上述约定与已有知识，再开始后续测试步骤
+
 ### 第 1 步：定位 Issue 并阅读上下文
 
 1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/bundled_templates/technical-design.md

@@ -78,19 +78,40 @@ sequenceDiagram
     Ctrl-->>C: 响应
 ```
 
-### 4.3 组件设计
+### 4.3 核心逻辑
 
-#### 4.3.1 {组件名称1}
+> 从 4.2 的宏观流程深入到具体实现。只描述有歧义或易出错的逻辑变更，显而易见的不必赘述。
 
-**职责**: {一句话描述}
+#### 4.3.1 {逻辑主题1}
 
-**关键逻辑**:
-{详细描述处理流程、校验规则、状态变更等核心逻辑}
+**变更概述**: {一句话说明这段逻辑做了什么改动、为什么改}
 
-**注意事项**:
-- {特殊点，如安全配置、拦截器排除、线程安全等}
+**关键逻辑（伪代码）**:
 
-#### 4.3.2 {组件名称2}
+```
+// 用伪代码描述核心判断/处理路径
+if condition_A:
+    do_step_1()
+    // 状态从 X 变为 Y
+elif condition_B:
+    do_step_2()
+else:
+    fallback()
+```
+
+**状态/规则变迁**（如有）:
+
+| 变更项 | 变更前 | 变更后 | 说明 |
+|--------|--------|--------|------|
+| {状态/规则/枚举} | {旧值或旧行为} | {新值或新行为} | {为什么改} |
+
+**新老代码差异**（涉及老代码改动时填写）:
+
+- **老逻辑**: {原来怎么做的、关键判断是什么}
+- **新逻辑**: {现在怎么做的、改了哪些判断}
+- **影响范围**: {这个改动会影响哪些上下游调用方或业务场景}
+
+#### 4.3.2 {逻辑主题2}
 
 {同上格式...}
 

{issuekit-0.1.3 → issuekit-0.1.4}/src/issuekit/knowledge/__init__.py

@@ -1,5 +1,5 @@
-"""知识库引擎 — 项目上下文知识摘要。
-
-knowledge skill 已包含在 bundled_skills/issuekit-knowledge/ 中，
-由 agent_skills.install_agent_skills() 统一安装。
-"""
+"""知识库引擎 — 项目上下文知识摘要。
+
+knowledge skill 已包含在 bundled_skills/issuekit-knowledge/ 中，
+由 agent_skills.install_agent_skills() 统一安装。
+"""