issuekit 0.1.0__py3-none-any.whl

issuekit/__init__.py

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

issuekit/agent_commands.py

@@ -0,0 +1,80 @@
+"""将 issuekit 命令文件安装到目标 AI 助手的命令目录。"""
+
+from importlib import resources
+from pathlib import Path
+
+from issuekit.agents.registry import AgentConfig
+
+COMMAND_FILES = [
+    "issuekit.require.md",
+    "issuekit.design.md",
+    "issuekit.coding.md",
+    "issuekit.test.md",
+    "issuekit.release.md",
+    "issuekit.review.md",
+    "issuekit.change.md",
+]
+
+
+def install_agent_commands(commands_dir: Path, agent_config: AgentConfig) -> int:
+    """安装所有 issuekit 命令文件，返回安装的文件数。"""
+    bundled = resources.files("issuekit") / "bundled_commands"
+    count = 0
+
+    for filename in COMMAND_FILES:
+        source = bundled / filename
+        if not source.is_file():
+            continue
+
+        content = source.read_text(encoding="utf-8")
+
+        if not agent_config.command_frontmatter:
+            content = _strip_frontmatter(content)
+
+        if not agent_config.supports_handoffs:
+            content = _strip_handoffs(content)
+
+        dest = commands_dir / f"{Path(filename).stem}{agent_config.command_ext}"
+        dest.write_text(content, encoding="utf-8")
+        count += 1
+
+    return count
+
+
+def _strip_frontmatter(content: str) -> str:
+    """移除 YAML frontmatter（--- ... ---）。"""
+    if content.startswith("---"):
+        end = content.find("---", 3)
+        if end != -1:
+            return content[end + 3:].lstrip("\n")
+    return content
+
+
+def _strip_handoffs(content: str) -> str:
+    """移除 YAML frontmatter 中的 handoffs 部分（用于不支持 handoffs 的 AI 助手）。"""
+    if not content.startswith("---"):
+        return content
+
+    end = content.find("---", 3)
+    if end == -1:
+        return content
+
+    frontmatter = content[3:end]
+    body = content[end + 3:]
+
+    lines = frontmatter.split("\n")
+    filtered = []
+    skip = False
+    for line in lines:
+        if line.strip().startswith("handoffs:"):
+            skip = True
+            continue
+        if skip and (line.startswith("  ") or line.startswith("\t")):
+            continue
+        skip = False
+        filtered.append(line)
+
+    new_frontmatter = "\n".join(filtered).strip()
+    if new_frontmatter:
+        return f"---\n{new_frontmatter}\n---{body}"
+    return body.lstrip("\n")

issuekit/agents/__init__.py

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

issuekit/agents/registry.py

@@ -0,0 +1,68 @@
+"""AI 助手配置注册表。
+
+每个助手定义了命令文件的存放位置和格式要求。
+"""
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class AgentConfig:
+    """AI 助手配置项。"""
+    name: str
+    commands_dir: str
+    rules_dir: Optional[str]
+    command_ext: str
+    command_frontmatter: bool
+    supports_handoffs: bool
+
+    def format_description(self) -> str:
+        return f"{self.name} ({self.commands_dir})"
+
+
+AGENT_REGISTRY: dict[str, AgentConfig] = {
+    "cursor": AgentConfig(
+        name="Cursor",
+        commands_dir=".cursor/commands",
+        rules_dir=".cursor/rules",
+        command_ext=".md",
+        command_frontmatter=True,
+        supports_handoffs=True,
+    ),
+    "claude": AgentConfig(
+        name="Claude Code",
+        commands_dir=".claude/commands",
+        rules_dir=None,
+        command_ext=".md",
+        command_frontmatter=False,
+        supports_handoffs=False,
+    ),
+    "codex": AgentConfig(
+        name="Codex",
+        commands_dir=".codex/commands",
+        rules_dir=None,
+        command_ext=".md",
+        command_frontmatter=False,
+        supports_handoffs=False,
+    ),
+    "copilot": AgentConfig(
+        name="GitHub Copilot",
+        commands_dir=".github/agents",
+        rules_dir=None,
+        command_ext=".md",
+        command_frontmatter=False,
+        supports_handoffs=False,
+    ),
+}
+
+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)

issuekit/bundled_commands/issuekit.change.md

@@ -0,0 +1,52 @@
+---
+description: 记录和管理 Issue 的需求或方案变更。追踪变更对所有文档的影响。
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+## 概述
+
+本命令处理开发过程中的需求变更、技术方案调整等，确保所有受影响的文档一致更新，变更被正确追踪。
+
+## 工作流程
+
+### 第 1 步：定位 Issue 并解析变更
+
+1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）
+2. 定位 issue 目录（从 `$ARGUMENTS` 或当前分支，issue 目录位于 `{issues_dir}/{issue-id}/`）
+3. 从 `$ARGUMENTS` 解析变更内容（用户提供的文字/图片）
+4. 分类变更类型：
+   - **需求变更**：产品需求发生变化
+   - **方案调整**：技术方案调整
+   - **配置变更**：配置项变化
+   - **范围变更**：需求范围扩大/缩小
+
+### 第 2 步：影响分析
+
+1. 阅读相关现有文档
+2. 对比变更内容与当前内容，识别差异
+3. 评估对下游文档的影响：
+   - 需求变更 → 可能影响：技术方案、测试方案、发布文档
+   - 方案调整 → 可能影响：测试方案、发布文档
+   - 范围变更 → 可能影响：所有文档
+
+### 第 3 步：更新受影响文档
+
+对每个受影响的文档：
+
+1. **原地更新内容**（保持可读性，不使用删除线）
+2. **追加变更记录条目**到文档的变更记录表：
+   ```
+   | v{N} | {日期} | {变更人} | {变更描述} | {原因} |
+   ```
+
+### 第 4 步：向用户报告
+
+1. 总结变更内容
+2. 列出所有更新的文档及版本号
+3. 如果下游文档需要手动更新（如技术方案需要重新设计），提醒用户并建议使用对应的命令
+4. 如果变更显著影响范围，建议重新运行需求文档的质量验证

issuekit/bundled_commands/issuekit.coding.md

@@ -0,0 +1,131 @@
+---
+description: 按技术方案进行编码实现。逐步执行开发步骤，完成后交叉校验代码与技术文档、需求文档的一致性，修复偏差。
+handoffs:
+  - label: 制定测试方案
+    agent: issuekit.test
+    prompt: 为这个 issue 制定测试方案
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+用户可以指定 issue ID，也可以从当前 git 分支自动推断。
+
+## 概述
+
+本命令按照技术方案文档进行编码实现，完成后通过交叉校验确保实现与技术文档、需求文档完全一致。
+
+## 前置条件
+
+- issue 目录中必须存在已确认的 `technical-design.md`
+- issue 目录中必须存在 `requirement.md`
+
+如果前置条件不满足，提示用户先完成前置步骤。
+
+## 工作流程
+
+### 第 1 步：定位 Issue 并阅读上下文
+
+1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）
+2. 定位 issue 目录（从 `$ARGUMENTS` 或当前 git 分支，issue 目录位于 `{issues_dir}/{issue-id}/`）
+3. 阅读 `technical-design.md`，重点关注：
+   - 技术调研（关注调研的结论）
+   - 开发步骤（按顺序执行的实操指南）
+   - 组件设计（职责、关键逻辑、注意事项）
+   - 接口设计（路径、请求/响应、错误处理）
+   - 数据模型（表结构、SQL 脚本）
+   - 配置变更（新增/修改的配置项）
+   - 项目结构（新增/修改的文件清单）
+4. 阅读 `requirement.md`，提取：
+   - 用户故事和流程
+   - 边界场景和处理方式
+   - 验收标准
+5. 阅读项目编码约定 `.issuekit/knowledge/conventions.md`（如有）
+
+### 第 2 步：按开发步骤编码
+
+严格按照 `technical-design.md` 中"开发步骤"章节的顺序逐步实现：
+
+1. 执行数据库变更（SQL 脚本）
+2. 新增枚举/常量/DTO
+3. 添加配置项
+4. 按依赖顺序开发核心代码：
+   - 遵循技术文档中的组件设计（职责划分、关键逻辑）
+   - 接口实现与技术文档中的接口设计保持一致（路径、参数、响应格式、错误处理）
+   - 数据模型与技术文档中的表结构一致
+5. 编写单元测试
+6. 执行本地验证
+
+**编码原则**：
+- 技术文档是编码的"施工图纸"，实现不应偏离设计
+- 遵循项目编码规范（分层架构、命名约定、日志规范等）
+- 如果编码过程中发现技术方案有缺陷或遗漏，先完成可实现的部分，在校验阶段统一记录
+
+### 第 3 步：交叉校验 — 技术文档一致性
+
+编码完成后，逐项对照 `technical-design.md` 校验实现：
+
+| 校验维度 | 校验内容 |
+|---------|---------|
+| 组件设计 | 每个组件的职责、关键逻辑是否按设计实现 |
+| 接口设计 | 请求路径、方法、参数、响应格式、错误处理是否一致 |
+| 数据模型 | 表结构、字段、索引、数据初始化是否一致 |
+| 核心流程 | 调用链、处理顺序是否与时序图一致 |
+| 配置变更 | 配置项是否已添加，key/value 是否正确 |
+| 项目结构 | 新增/修改的文件是否与清单一致 |
+
+**对每个校验项**：
+- ✅ 一致 → 通过
+- ❌ 不一致 → 记录偏差，修复代码使其与设计一致
+- ⚠️ 设计有缺陷 → 记录问题，按合理方式实现，标记需要回头更新技术文档
+
+### 第 4 步：交叉校验 — 需求文档一致性
+
+对照 `requirement.md` 校验功能实现：
+
+| 校验维度 | 校验内容 |
+|---------|---------|
+| 用户故事 | 每个 US 的流程是否已完整实现 |
+| 边界场景 | 表格中列出的每个边界场景是否已处理 |
+| 验收标准 | 每条 AC 是否可通过当前实现满足 |
+
+**对每个校验项**：
+- ✅ 已实现 → 通过
+- ❌ 未实现 → 补充实现
+- ⚠️ 需求描述模糊导致无法判断 → 按合理默认值实现，标记提醒
+
+### 第 5 步：修复偏差
+
+根据第 3、4 步发现的不一致项，逐一修复：
+
+1. 代码与技术文档不一致 → 修改代码对齐设计
+2. 功能未覆盖需求 → 补充实现
+3. 技术文档本身有缺陷 → 修改代码为合理实现，在报告中标记需更新技术文档
+
+修复后重新执行校验，直到所有项目通过。
+
+### 第 6 步：报告完成
+
+向用户报告：
+
+```
+编码完成 ✓
+━━━━━━━━━━━━━━━━━━━━
+技术文档校验：{N}/{Total} 通过
+需求文档校验：{N}/{Total} 通过
+
+新增文件：
+- {文件列表}
+
+修改文件：
+- {文件列表}
+
+{如有技术文档缺陷标记}
+⚠️ 以下设计需要回头更新技术文档：
+- {问题描述}
+
+建议下一步：运行 /issuekit.test 制定测试方案
+```

issuekit/bundled_commands/issuekit.design.md

@@ -0,0 +1,116 @@
+---
+description: 为 Issue 设计技术方案。技术调研、架构设计、接口设计、组件设计、开发步骤，一份文档涵盖完整技术方案。
+handoffs:
+  - label: 开始编码
+    agent: issuekit.coding
+    prompt: 按技术方案开始编码实现
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+用户可以指定 issue ID，也可以从当前 git 分支自动推断。
+
+## 概述
+
+本命令为 issue 生成一份完整的技术方案文档（`technical-design.md`），涵盖从技术调研到开发指南的全流程。
+
+## 前置条件
+
+- issue 目录中必须存在 `requirement.md`
+- 需求状态应为"已确认"（待确认问题已解决）
+
+如果前置条件不满足，提示用户先运行 `/issuekit.require` 或解决待确认问题。
+
+## 工作流程
+
+### 第 1 步：定位 Issue
+
+1. 如果 `$ARGUMENTS` 中包含 issue ID，直接使用
+2. 否则从当前 git 分支名提取（例如 `feature/FEAT-20260305-xxx` → `FEAT-20260305-xxx`）
+3. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）
+4. 验证 `{issues_dir}/{issue-id}/requirement.md` 存在
+
+### 第 2 步：阅读上下文
+
+1. 阅读 `requirement.md` 获取已确认的需求、用户故事、验收标准
+2. 阅读项目知识摘要 `.issuekit/knowledge/`（如有）
+3. 阅读项目编码约定 `.issuekit/knowledge/conventions.md`（如有）
+4. 深入分析相关代码的当前实现：
+   - 沿所有受影响的调用链阅读源码
+   - 理解现有数据模型和数据库结构
+   - 检查当前配置和功能开关
+   - 找到可复用的现有模式
+
+### 第 3 步：技术调研
+
+识别方案中的技术未知项和关键决策点，逐一调研并记录结论：
+
+1. **提取未知项**：从需求和代码分析中识别需要调研的点
+   - 不熟悉的技术/SDK 用法
+   - 多种实现方式的技术选型
+   - 外部依赖的能力和限制
+   - 性能/规模方面的不确定性
+
+2. **调研并决策**：针对每个未知项
+   - 搜索文档/源码/最佳实践
+   - 明确选择了什么方案
+   - 为什么选这个、考虑了哪些替代方案
+
+3. 如果没有技术未知项（方案清晰明确），可跳过此步骤并在文档中注明。
+
+### 第 4 步：方案设计
+
+完成完整的技术方案设计：
+
+1. **整体架构**：架构层面的实现决策，Mermaid 架构图
+2. **核心流程**：关键处理路径的 Mermaid sequenceDiagram / flowchart
+3. **组件设计**：每个新增/修改的核心组件
+   - 职责说明
+   - 关键逻辑（处理流程、校验规则、状态变更）
+   - 需要注意的特殊点
+4. **接口设计**：每个新增/修改的接口
+   - 请求路径、方法、Headers
+   - 请求体/响应体的完整 JSON 示例
+   - 错误处理表（场景 → 处理方式 → 日志级别）
+   - 处理流程（文字或 Mermaid flowchart）
+5. **数据模型**：新增/修改的表结构、字段、索引、SQL 脚本
+6. **配置变更**：配置文件的新增/修改项
+7. **项目结构**：列出所有新增/修改的文件，标注模块和变更类型
+
+### 第 5 步：影响分析与风险评估
+
+1. **功能影响**：哪些现有功能受影响，需要回归测试
+2. **性能影响**：QPS 预估、查询复杂度、缓存策略
+3. **兼容性**：接口/数据/客户端版本兼容性
+4. **风险清单**：每个风险的概率、影响和应对措施
+
+### 第 6 步：开发步骤
+
+按执行顺序列出开发实施步骤，作为开发者的实操指南：
+- 数据库变更（SQL 脚本）
+- 枚举/常量新增
+- 配置项添加
+- 核心代码开发（按依赖顺序）
+- 单元测试编写
+- 本地验证方法
+- 集成验证方法
+
+### 第 7 步：生成技术方案文档
+
+加载模板 `.issuekit/templates/technical-design.md` 并填充所有章节。
+
+关键要求：
+- 所有代码位置必须使用可点击链接：`[Class#method](path/File.java)`（相对项目根目录）
+- 使用 Mermaid 图表展示架构、时序流程和类关系
+- 接口设计要包含完整的请求/响应 JSON 示例和错误处理表
+- 组件设计要具体到关键逻辑，不能只写职责概述
+- 开发步骤要可直接按顺序执行
+
+### 第 8 步：写入文件并报告
+
+1. 将 `technical-design.md` 写入 issue 目录
+2. 报告完成并建议下一步：`/issuekit.coding`

issuekit/bundled_commands/issuekit.knowledge.md

@@ -0,0 +1,117 @@
+---
+description: 分析当前项目，生成结构化的上下文知识摘要到 .issuekit/knowledge/，供其他 issuekit 命令使用。
+---
+
+## 概述
+
+本命令分析当前项目的代码、配置和结构，生成一系列知识摘要文件。这些摘要让 AI Agent 在执行需求分析、技术方案设计等任务时，能快速理解项目上下文，而无需每次从零扫描。
+
+**输出目录**: `.issuekit/knowledge/`
+
+## 工作流程
+
+### 第 1 步：检测项目类型
+
+自动识别项目的技术栈和构建系统：
+
+1. 扫描项目根目录的构建/配置文件：
+   - `pom.xml` / `build.gradle` → Java/Kotlin
+   - `package.json` → JavaScript/TypeScript
+   - `go.mod` → Go
+   - `requirements.txt` / `pyproject.toml` / `setup.py` → Python
+   - `Cargo.toml` → Rust
+   - `*.csproj` / `*.sln` → C#/.NET
+   - 其他构建文件 → 按实际情况处理
+2. 读取依赖配置，提取所有依赖及版本
+3. 读取应用配置文件（如 application.yml, .env, config/ 等）识别中间件和外部服务
+
+### 第 2 步：项目概览
+
+生成 `.issuekit/knowledge/project-overview.md`：
+
+- 项目名称和简要描述（从 README 或配置推断）
+- 目录结构树（关键目录 + 一句话说明）
+- 技术栈表格（类别 | 技术 | 版本 | 用途）
+- 代码规模统计（按语言/模块的文件数和行数）
+- Git 活跃度（近 6 个月的提交频率、主要贡献者）
+
+### 第 3 步：架构分析
+
+生成 `.issuekit/knowledge/architecture.md`：
+
+- 分层架构（识别项目的层级划分，如 Controller/Service/DAO 或其他模式）
+- 每层的职责描述
+- 模块间依赖关系（Mermaid 图）
+- 设计模式识别（策略、工厂、适配器等，标注使用位置）
+- 横切关注点（缓存、事务、异常处理、配置管理、安全/认证）
+
+### 第 4 步：API 接口摘要
+
+生成 `.issuekit/knowledge/api-surface.md`：
+
+- 扫描所有 API 端点（HTTP 路由、gRPC 服务、GraphQL schema 等）
+- 按业务模块分组
+- 每个端点：方法、路径、简要说明
+- 请求/响应的通用约定（统一返回体、错误码规范、参数校验方式）
+- API 数量统计（按模块分布饼图）
+
+### 第 5 步：数据模型摘要
+
+生成 `.issuekit/knowledge/data-model.md`：
+
+- 扫描 ORM 实体/模型定义
+- 如果有 MCP 数据库连接可用：
+  1. 先验证该数据库连接与当前项目相关（检查 MCP 的数据库连接字符串中的数据库名称、主机等信息，与项目配置文件中的数据库配置做比对）
+  2. 如果确认相关，查询实际表结构
+  3. 如果无法确认相关性或明确不相关，跳过数据库查询并在文档中注明"未使用 MCP 数据库查询：无法确认数据库连接与当前项目相关"，避免不相关的数据库信息误导后续分析
+- 按业务域分组列出表/实体
+- 核心表的关系图（Mermaid erDiagram）
+- 标注实体类在代码中的位置
+
+### 第 6 步：外部集成摘要
+
+生成 `.issuekit/knowledge/integrations.md`：
+
+- 识别所有外部服务集成（SDK、REST API、gRPC、消息队列、缓存等）
+- 每个集成：服务名、集成方式、适配类/客户端位置、配置项
+- 外部依赖拓扑图（Mermaid flowchart）
+
+### 第 7 步：编码约定摘要
+
+生成 `.issuekit/knowledge/conventions.md`：
+
+- 从现有代码推断编码风格和约定
+- 命名约定（类名、方法名、变量名、数据库表/列）
+- 日志使用方式
+- 错误处理模式
+- 如果项目已有规范文件（如 .cursor/rules/, .editorconfig, linter 配置），整合其内容
+
+### 第 8 步：报告完成
+
+```
+知识库更新完成 ✓
+━━━━━━━━━━━━━━━━━━━━
+生成文件：
+- .issuekit/knowledge/project-overview.md
+- .issuekit/knowledge/architecture.md
+- .issuekit/knowledge/api-surface.md
+- .issuekit/knowledge/data-model.md
+- .issuekit/knowledge/integrations.md
+- .issuekit/knowledge/conventions.md
+
+后续命令（如 /issuekit.require、/issuekit.design）将自动读取这些知识摘要。
+```
+
+## AI 执行指南
+
+### 通用化原则
+
+- 不假设任何特定的语言或框架，根据实际项目自适应
+- 如果某个步骤不适用（如项目无数据库），跳过并注明
+- 优先使用 Mermaid 图表，文字作为补充
+- 所有关键入口使用可点击的相对路径链接
+
+### 增量更新
+
+- 如果知识文件已存在，对比后仅更新有变化的部分
+- 在每个文件末尾记录最后更新时间

issuekit/bundled_commands/issuekit.release.md

@@ -0,0 +1,90 @@
+---
+description: 准备发布文档并创建 Pull Request。分析代码变更，对比技术方案，生成部署指南。
+handoffs:
+  - label: 代码审核
+    agent: issuekit.review
+    prompt: 审核这个 issue 的代码
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+## 概述
+
+本命令生成发布文档并创建 Pull Request。分析特性分支上的所有代码变更，对比技术方案，生成部署指南。
+
+## 前置条件
+
+- 开发和测试已完成
+- 代码已提交到特性分支
+- issue 目录中存在 `technical-design.md` 和 `test-plan.md`
+
+## 工作流程
+
+### 第 1 步：定位 Issue 并分析变更
+
+1. 读取 `.issuekit/config.yaml` 中的 `issues_dir` 配置项，获取 Issue 文档存放目录（默认为 `issues`）
+2. 定位 issue 目录（从 `$ARGUMENTS` 或当前分支）
+3. 运行 `git diff master...HEAD` 收集所有代码变更
+4. 运行 `git log master..HEAD --oneline` 列出所有提交
+
+### 第 2 步：阅读上下文
+
+1. 阅读 `technical-design.md` 获取设计方案
+2. 阅读 `test-plan.md` 获取测试覆盖和结果
+3. 阅读 `requirement.md` 获取原始需求
+
+### 第 3 步：对比方案与实际实现
+
+将技术方案与实际代码变更对比：
+- 识别已实现的项目
+- 标记偏离设计的地方
+- 记录计划外的变更
+
+### 第 4 步：生成发布文档
+
+加载模板 `.issuekit/templates/release-note.md` 并填充所有章节：
+
+- 变更概述
+- 需求变更汇总
+- 详细变更清单（功能、接口、数据库、配置）
+- 影响范围
+- 部署步骤（有序检查清单）
+- 回滚方案
+- 监控与告警
+- 发布后验证
+
+### 第 5 步：创建 Pull Request
+
+```bash
+git push -u origin HEAD
+gh pr create --title "{Issue ID}: {摘要}" --body "$(cat <<'EOF'
+## 概述
+{发布文档中的关键变更}
+
+## 变更清单
+{变更列表}
+
+## 测试情况
+{测试覆盖摘要}
+
+## 部署说明
+{部署步骤（如有）}
+
+## 相关文档
+- 需求文档：{issues_dir}/{issue-id}/requirement.md
+- 技术方案：{issues_dir}/{issue-id}/technical-design.md
+- 测试方案：{issues_dir}/{issue-id}/test-plan.md
+- 发布文档：{issues_dir}/{issue-id}/release-note.md
+
+EOF
+)"
+```
+
+### 第 6 步：写入文件并报告
+
+1. 将 `release-note.md` 写入 issue 目录
+2. 报告 PR 链接并建议下一步：`/issuekit.review`