dsh-github-flow 0.1.0

package/lib/commands/gh.js

@@ -0,0 +1,63 @@
+export function registerGhCommand(ctx, executor) {
+    const commandsService = ctx.get ? ctx.get('commands') : ctx.commands;
+    if (!commandsService || typeof commandsService.register !== 'function')
+        return;
+    const doRegister = () => {
+        return commandsService.register({
+            name: 'gh',
+            description: 'GitHub CLI 状态与诊断快捷指令',
+            async handler({ rawInput }) {
+                const trimmed = (rawInput || '').trim();
+                if (!trimmed || trimmed === 'status') {
+                    const auth = await executor.checkAuth();
+                    const repo = await executor.getRepoMetadata();
+                    let md = `### GitHub 集成状态\n\n`;
+                    if (auth.loggedIn) {
+                        md += `- **登录账号**: \`${auth.user || '已登录'}\`\n`;
+                        md += `- **授权作用域**: ${auth.scopes?.map((s) => `\`${s}\``).join(', ') || '标准权限'}\n`;
+                    }
+                    else {
+                        md += `- **登录状态**: ❌ 未登录 GitHub\n`;
+                        md += `> 提示：请在系统终端执行 \`gh auth login\` 进行登录。\n`;
+                    }
+                    if (repo) {
+                        md += `\n**当前关联仓库**:\n`;
+                        md += `- 仓库名: [${repo.nameWithOwner}](${repo.url})\n`;
+                        md += `- 默认分支: \`${repo.defaultBranch}\`\n`;
+                        if (repo.description)
+                            md += `- 简介: ${repo.description}\n`;
+                    }
+                    else {
+                        md += `\n*当前目录尚未关联 Git 远程仓库或未托管在 GitHub。*\n`;
+                    }
+                    return {
+                        kind: 'markdown',
+                        text: md,
+                    };
+                }
+                if (trimmed === 'help') {
+                    return {
+                        kind: 'markdown',
+                        text: `### DSH GitHub Flow 帮助\n\n- \`/gh status\`: 检查当前 GitHub CLI 账号与仓库连接\n- \`/gh help\`: 显示此帮助信息\n\n可以在对话中直接让 Agent 操作 GitHub，如：\n- *"查看当前仓库有哪些开放的 PR"* \n- *"查看最近一次 CI 失败的原因"* \n- *"帮我给当前分支创建 PR"*`,
+                    };
+                }
+                return {
+                    kind: 'error',
+                    text: `未知命令选项: /gh ${trimmed}。可用用法: /gh status, /gh help`,
+                };
+            },
+        });
+    };
+    if (ctx.effect) {
+        ctx.effect(() => {
+            const dispose = doRegister();
+            return () => {
+                if (typeof dispose === 'function')
+                    dispose();
+            };
+        }, 'github-flow: gh command');
+    }
+    else {
+        doRegister();
+    }
+}

package/lib/executor.d.ts

@@ -0,0 +1,22 @@
+import type { GhExecutionOptions, GhResult, AuthStatus, RepoMetadata, PluginConfig } from './types.js';
+export declare class GhExecutor {
+    ghPath: string;
+    defaultTimeoutMs: number;
+    maxOutputChars: number;
+    constructor(config?: PluginConfig);
+    updateConfig(config?: PluginConfig): void;
+    /**
+     * 安全执行 gh 命令
+     * 采用 execFile 参数数组隔离，彻底杜绝 Shell 字符串拼接注入漏洞
+     */
+    run<T = unknown>(args: string[], options?: GhExecutionOptions): Promise<GhResult<T>>;
+    /**
+     * 检查宿主机当前 GitHub CLI 的认证状态与账号信息
+     */
+    checkAuth(cwd?: string): Promise<AuthStatus>;
+    /**
+     * 获取当前目录（工作区）关联的远程仓库元数据
+     * 采用 gh repo view + 本地 git remote 双保险机制，彻底杜绝已配置远程却误判未关联的问题
+     */
+    getRepoMetadata(cwd?: string): Promise<RepoMetadata | null>;
+}

package/lib/executor.js

@@ -0,0 +1,207 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export class GhExecutor {
+    ghPath;
+    defaultTimeoutMs;
+    maxOutputChars;
+    constructor(config = {}) {
+        this.ghPath = config.ghPath || 'gh';
+        this.defaultTimeoutMs = config.defaultTimeoutMs || 30_000;
+        this.maxOutputChars = config.maxOutputChars || 24_000;
+    }
+    updateConfig(config = {}) {
+        if (config.ghPath)
+            this.ghPath = config.ghPath;
+        if (config.defaultTimeoutMs)
+            this.defaultTimeoutMs = config.defaultTimeoutMs;
+        if (config.maxOutputChars)
+            this.maxOutputChars = config.maxOutputChars;
+    }
+    /**
+     * 安全执行 gh 命令
+     * 采用 execFile 参数数组隔离，彻底杜绝 Shell 字符串拼接注入漏洞
+     */
+    async run(args, options = {}) {
+        const cwd = options.cwd || process.cwd();
+        const timeout = options.timeoutMs || this.defaultTimeoutMs;
+        try {
+            const { stdout, stderr } = await execFileAsync(this.ghPath, args, {
+                cwd,
+                timeout,
+                maxBuffer: 15 * 1024 * 1024, // 15MB 进程缓冲
+                env: {
+                    ...process.env,
+                    GH_NO_UPDATE_NOTIFIER: '1', // 禁用 CLI 版本更新检查，避免污染 stdout
+                    NO_COLOR: '1', // 禁用 ANSI 颜色转义字符
+                    ...options.env,
+                },
+            });
+            let rawOutput = (stdout || '').trim();
+            if (!rawOutput && stderr) {
+                rawOutput = stderr.trim();
+            }
+            let truncated = false;
+            if (rawOutput.length > this.maxOutputChars) {
+                // 保留前 1/3 字符和尾部 1/2 字符，保留开头上下文和错误尾部
+                const headLen = Math.floor(this.maxOutputChars * 0.35);
+                const tailLen = Math.floor(this.maxOutputChars * 0.55);
+                const head = rawOutput.slice(0, headLen);
+                const tail = rawOutput.slice(-tailLen);
+                rawOutput = `${head}\n\n... [⚠️ 提示：内容过长已由 DSH GitHub 插件截断中间部分，当前截取前 ${Math.round(headLen / 1024)}KB 与后 ${Math.round(tailLen / 1024)}KB] ...\n\n${tail}`;
+                truncated = true;
+            }
+            // 如果未被截断且命令带有 --json 或包含 api，尝试解析为 JSON
+            if (!options.rawText && !truncated && (args.includes('--json') || args.includes('api'))) {
+                try {
+                    const parsed = JSON.parse(rawOutput);
+                    return { ok: true, data: parsed, rawOutput, truncated: false };
+                }
+                catch {
+                    // 部分特殊命令可能输出空数组或文本，降级为 rawOutput
+                    return { ok: true, rawOutput, truncated };
+                }
+            }
+            return { ok: true, rawOutput, truncated };
+        }
+        catch (err) {
+            let friendlyError = err.message || '执行失败';
+            if (err.code === 'ENOENT') {
+                friendlyError = '系统未检测到 GitHub CLI (gh)。请先在系统终端安装: Windows 运行 `winget install GitHub.cli`，macOS 运行 `brew install gh`。';
+            }
+            else if (err.killed && err.signal === 'SIGTERM') {
+                friendlyError = `GitHub CLI 命令执行超时 (${timeout}ms)。请检查网络连通性。`;
+            }
+            else if (err.stderr) {
+                const stderrText = String(err.stderr).trim();
+                if (stderrText.includes('gh auth login') || stderrText.includes('authentication required')) {
+                    friendlyError = 'GitHub 尚未登录。请在系统终端执行 `gh auth login`，或在聊天框输入 `/gh status` 查看诊断。';
+                }
+                else {
+                    friendlyError = stderrText;
+                }
+            }
+            return {
+                ok: false,
+                error: friendlyError,
+            };
+        }
+    }
+    /**
+     * 检查宿主机当前 GitHub CLI 的认证状态与账号信息
+     */
+    async checkAuth(cwd) {
+        const res = await this.run(['auth', 'status'], { cwd, timeoutMs: 10_000, rawText: true });
+        const raw = (res.rawOutput || '') + '\n' + (res.error || '');
+        const loggedIn = raw.includes('Logged in to') || raw.includes('✓');
+        // 只要已登录或有常规输出，则必然安装了 gh
+        const isNotInstalled = Boolean(res.error && res.error.includes('系统未检测到 GitHub CLI'));
+        const installed = loggedIn || !isNotInstalled;
+        if (!installed) {
+            return {
+                installed: false,
+                loggedIn: false,
+                platform: process.platform,
+                raw: res.error,
+            };
+        }
+        if (!loggedIn) {
+            return {
+                installed: true,
+                loggedIn: false,
+                platform: process.platform,
+                raw,
+            };
+        }
+        // 解析用户名
+        let user;
+        const accountMatch = raw.match(/account\s+([A-Za-z0-9_-]+)/i);
+        if (accountMatch) {
+            user = accountMatch[1];
+        }
+        // 解析 Token scopes
+        let scopes;
+        const scopesMatch = raw.match(/Token scopes:\s*([^\r\n]+)/i);
+        if (scopesMatch) {
+            scopes = scopesMatch[1]
+                .split(',')
+                .map((s) => s.replace(/['"`]/g, '').trim())
+                .filter(Boolean);
+        }
+        return {
+            installed: true,
+            loggedIn: true,
+            platform: process.platform,
+            user,
+            host: 'github.com',
+            activeAccount: raw.includes('Active account: true'),
+            scopes,
+            raw,
+        };
+    }
+    /**
+     * 获取当前目录（工作区）关联的远程仓库元数据
+     * 采用 gh repo view + 本地 git remote 双保险机制，彻底杜绝已配置远程却误判未关联的问题
+     */
+    async getRepoMetadata(cwd) {
+        const targetCwd = cwd || process.cwd();
+        // 1. 优先尝试由 gh 直接根据当前上下文识别
+        const res = await this.run(['repo', 'view', '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
+        if (res.ok && res.data && res.data.nameWithOwner) {
+            const d = res.data;
+            return {
+                nameWithOwner: d.nameWithOwner || '',
+                name: d.name || '',
+                owner: d.owner?.login || '',
+                defaultBranch: d.defaultBranchRef?.name || 'main',
+                description: d.description || '',
+                isPrivate: Boolean(d.isPrivate),
+                url: d.url || `https://github.com/${d.nameWithOwner}`,
+            };
+        }
+        // 2. 双保险兜底：如果 gh 未能自动推断（如当前分支未推送到 upstream），直接解析本地 git remote
+        try {
+            const { execFile } = await import('node:child_process');
+            const { promisify } = await import('node:util');
+            const execAsync = promisify(execFile);
+            const { stdout: remoteOut } = await execAsync('git', ['remote', '-v'], { cwd: targetCwd });
+            if (remoteOut) {
+                // 匹配 github.com 格式：git@github.com:owner/repo.git 或 https://github.com/owner/repo.git
+                const match = remoteOut.match(/github\.com[:/]([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+?)(?:\.git)?(?:\s|\()/i);
+                if (match) {
+                    const owner = match[1];
+                    const repoName = match[2];
+                    const nameWithOwner = `${owner}/${repoName}`;
+                    // 使用提取出的精确 owner/repo 向 gh 获取元数据
+                    const directRes = await this.run(['repo', 'view', nameWithOwner, '--json', 'nameWithOwner,name,owner,defaultBranchRef,description,isPrivate,url'], { cwd: targetCwd, timeoutMs: 10_000 });
+                    if (directRes.ok && directRes.data && directRes.data.nameWithOwner) {
+                        const d = directRes.data;
+                        return {
+                            nameWithOwner: d.nameWithOwner || nameWithOwner,
+                            name: d.name || repoName,
+                            owner: d.owner?.login || owner,
+                            defaultBranch: d.defaultBranchRef?.name || 'main',
+                            description: d.description || '',
+                            isPrivate: Boolean(d.isPrivate),
+                            url: d.url || `https://github.com/${nameWithOwner}`,
+                        };
+                    }
+                    // 若离线或网络受限，由本地 git remote 配置兜底返回
+                    return {
+                        nameWithOwner,
+                        name: repoName,
+                        owner,
+                        defaultBranch: 'main',
+                        description: '已成功关联本地 Git 远程仓库',
+                        isPrivate: false,
+                        url: `https://github.com/${nameWithOwner}`,
+                    };
+                }
+            }
+        }
+        catch {
+            // 本地无 git 或无 remote 配置
+        }
+        return null;
+    }
+}

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+import Schema from '@deepseek-ai/schemastery';
+import type { PluginConfig } from './types.js';
+export declare const name = "dsh-github-flow";
+/**
+ * 仅将核心基础服务作为硬性依赖，解绑 webServer 与 commands。
+ * 在无 Web 界面环境（如 Headless、纯终端、CI 自动化模式）下也能即刻激活，杜绝 PENDING 卡死。
+ */
+export declare const inject: readonly ['tools'];
+/**
+ * 遵循官方 Cordis 规范导出的强类型配置接口与运行时校验器
+ */
+export interface Config extends PluginConfig {
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: any, config?: Config): void;
+export { GitHubService } from './service.js';
+export * from './types.js';

package/lib/index.js

@@ -0,0 +1,57 @@
+import Schema from '@deepseek-ai/schemastery';
+import { GhExecutor } from './executor.js';
+import { GitHubService } from './service.js';
+import { createPrTool } from './tools/pr.js';
+import { createIssueTool } from './tools/issue.js';
+import { createRunTool } from './tools/run.js';
+import { createRepoTool } from './tools/repo.js';
+import { createApiTool } from './tools/api.js';
+import { registerGhCommand } from './commands/gh.js';
+import { registerApiRoutes } from './api/routes.js';
+export const name = 'dsh-github-flow';
+/**
+ * 仅将核心基础服务作为硬性依赖，解绑 webServer 与 commands。
+ * 在无 Web 界面环境（如 Headless、纯终端、CI 自动化模式）下也能即刻激活，杜绝 PENDING 卡死。
+ */
+export const inject = ['tools'];
+export const Config = Schema.object({
+    ghPath: Schema.string().default('gh').description('GitHub CLI (gh) 二进制可执行文件路径'),
+    defaultTimeoutMs: Schema.number().default(30000).description('CLI 命令执行超时毫秒数'),
+    maxOutputChars: Schema.number().default(24000).description('防止 Token 溢出的单次截断安全阈值字符数'),
+    cacheTtlMs: Schema.number().default(15000).description('Web API 概览数据缓存有效时长 (ms)'),
+    defaultListLimit: Schema.number().default(20).description('默认查询列表返回条数'),
+});
+export function apply(ctx, config = {}) {
+    // 1. 初始化具备动态配置能力的执行引擎
+    const executor = new GhExecutor(config);
+    // 2. 将核心能力提升挂载为 Cordis 原生微内核服务 (ctx.github)
+    new GitHubService(ctx, executor);
+    // 3. 注册 Agent 模型工具集（5 大核心领域工具）
+    if (ctx.tools && typeof ctx.tools.register === 'function') {
+        ctx.tools.register(createPrTool(executor));
+        ctx.tools.register(createIssueTool(executor));
+        ctx.tools.register(createRunTool(executor));
+        ctx.tools.register(createRepoTool(executor));
+        ctx.tools.register(createApiTool(executor));
+    }
+    // 4. 可选依赖：命令服务（存在时动态激活，不阻塞主流程）
+    if (ctx.inject && typeof ctx.inject === 'function') {
+        ctx.inject(['commands'], (innerCtx) => {
+            registerGhCommand(innerCtx, executor);
+        });
+    }
+    else if (ctx.commands) {
+        registerGhCommand(ctx, executor);
+    }
+    // 5. 可选依赖：Web 界面服务（存在时动态注入路由并由 effect 管理生命周期）
+    if (ctx.inject && typeof ctx.inject === 'function') {
+        ctx.inject(['webServer'], (innerCtx) => {
+            registerApiRoutes(innerCtx, executor, config);
+        });
+    }
+    else if (ctx.webServer) {
+        registerApiRoutes(ctx, executor, config);
+    }
+}
+export { GitHubService } from './service.js';
+export * from './types.js';

package/lib/service.d.ts

@@ -0,0 +1,28 @@
+import type { GhExecutor } from './executor.js';
+import type { GhExecutionOptions, GhResult, AuthStatus, RepoMetadata } from './types.js';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        github: GitHubService;
+    }
+}
+/**
+ * DSH GitHub 原生微内核服务
+ * 允许生态内其他插件通过 ctx.github 或 inject: ['github'] 消费 GitHub CLI 能力
+ */
+export declare class GitHubService {
+    private ctx;
+    executor: GhExecutor;
+    constructor(ctx: any, executor: GhExecutor);
+    /**
+     * 执行原生 gh 命令
+     */
+    run<T = unknown>(args: string[], options?: GhExecutionOptions): Promise<GhResult<T>>;
+    /**
+     * 检查宿主机 GitHub CLI 认证状态
+     */
+    checkAuth(cwd?: string): Promise<AuthStatus>;
+    /**
+     * 获取指定工作区路径下的 Git 关联元数据
+     */
+    getRepoMetadata(cwd?: string): Promise<RepoMetadata | null>;
+}

package/lib/service.js

@@ -0,0 +1,34 @@
+/**
+ * DSH GitHub 原生微内核服务
+ * 允许生态内其他插件通过 ctx.github 或 inject: ['github'] 消费 GitHub CLI 能力
+ */
+export class GitHubService {
+    ctx;
+    executor;
+    constructor(ctx, executor) {
+        this.ctx = ctx;
+        this.executor = executor;
+        // 挂载到 ctx 上
+        if (ctx) {
+            ctx.github = this;
+        }
+    }
+    /**
+     * 执行原生 gh 命令
+     */
+    async run(args, options = {}) {
+        return this.executor.run(args, options);
+    }
+    /**
+     * 检查宿主机 GitHub CLI 认证状态
+     */
+    async checkAuth(cwd) {
+        return this.executor.checkAuth(cwd);
+    }
+    /**
+     * 获取指定工作区路径下的 Git 关联元数据
+     */
+    async getRepoMetadata(cwd) {
+        return this.executor.getRepoMetadata(cwd);
+    }
+}

package/lib/tools/api.d.ts

@@ -0,0 +1,2 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createApiTool(executor: GhExecutor): any;

package/lib/tools/api.js

@@ -0,0 +1,55 @@
+import { defineSafeTool } from './define.js';
+export function createApiTool(executor) {
+    return defineSafeTool({
+        name: 'github_api',
+        description: '通过 GitHub CLI 认证环境直接调用任意 GitHub REST 或 GraphQL API 端点（兜底逃生门）。支持 --jq 过滤。',
+        parameters: {
+            type: 'object',
+            properties: {
+                endpoint: {
+                    type: 'string',
+                    description: 'API 端点路径，例如 repos/{owner}/{repo}/releases 或 /user',
+                },
+                method: {
+                    type: 'string',
+                    enum: ['GET', 'POST', 'PATCH', 'DELETE'],
+                    description: 'HTTP 方法，默认为 GET。',
+                },
+                jq: {
+                    type: 'string',
+                    description: '用于在 gh 内部预先过滤结果的 jq 表达式，极大精简返回结果。',
+                },
+                fields: {
+                    type: 'object',
+                    description: '请求参数或请求体键值对。',
+                },
+            },
+            required: ['endpoint'],
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const cmd = ['api', args.endpoint];
+            if (args.method && args.method !== 'GET') {
+                cmd.push('-X', args.method);
+            }
+            if (args.jq) {
+                cmd.push('--jq', args.jq);
+            }
+            if (args.fields && typeof args.fields === 'object') {
+                for (const [k, v] of Object.entries(args.fields)) {
+                    cmd.push('-F', `${k}=${typeof v === 'object' ? JSON.stringify(v) : v}`);
+                }
+            }
+            const res = await executor.run(cmd, { cwd });
+            if (!res.ok)
+                throw new Error(res.error);
+            return res.data || res.rawOutput;
+        },
+    });
+}

package/lib/tools/define.d.ts

@@ -0,0 +1,6 @@
+/**
+ * DSH Tool 定义规范包装器
+ * 优先使用 @deepseek-ai/dsh-tools 的 defineTool DSL
+ * 在独立环境无此包时提供标准的运行时安全包装
+ */
+export declare function defineSafeTool(spec: any): any;

package/lib/tools/define.js

@@ -0,0 +1,15 @@
+/**
+ * DSH Tool 定义规范包装器
+ * 优先使用 @deepseek-ai/dsh-tools 的 defineTool DSL
+ * 在独立环境无此包时提供标准的运行时安全包装
+ */
+export function defineSafeTool(spec) {
+    try {
+        const dshTools = globalThis.__DSH_TOOLS__;
+        if (dshTools && typeof dshTools.defineTool === 'function') {
+            return dshTools.defineTool(spec);
+        }
+    }
+    catch (e) { }
+    return spec;
+}

package/lib/tools/issue.d.ts

@@ -0,0 +1,2 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createIssueTool(executor: GhExecutor): any;

package/lib/tools/issue.js

@@ -0,0 +1,109 @@
+import { defineSafeTool } from './define.js';
+export function createIssueTool(executor) {
+    return defineSafeTool({
+        name: 'github_issue',
+        description: '管理 GitHub Issues。支持查看 Issue 列表、详情、创建新 Issue、追加评论以及关闭 Issue。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'view', 'create', 'comment', 'close', 'reopen'],
+                    description: 'Issue 操作类型。',
+                },
+                issue_number: {
+                    type: 'number',
+                    description: 'Issue 编号（view, comment, close, reopen 时使用）。',
+                },
+                repo: {
+                    type: 'string',
+                    description: '目标仓库 [owner/repo]，留空则识别当前仓库。',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Issue 标题（create 时使用）。',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Issue 描述正文或追加评论内容。',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '标签名称列表。',
+                },
+                assignees: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '被指派人的 GitHub 登录名列表。',
+                },
+            },
+            required: ['action'],
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            switch (args.action) {
+                case 'list': {
+                    const res = await executor.run(['issue', 'list', ...repoArgs, '--json', 'number,title,state,author,labels,updatedAt', '-L', '20'], { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return res.data || res.rawOutput;
+                }
+                case 'view': {
+                    if (!args.issue_number)
+                        throw new Error('view 操作必须提供 issue_number');
+                    const res = await executor.run(['issue', 'view', String(args.issue_number), ...repoArgs, '--json', 'number,title,body,state,author,labels,assignees,comments,url'], { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return res.data || res.rawOutput;
+                }
+                case 'create': {
+                    const cmd = ['issue', 'create', ...repoArgs, '--title', args.title || '', '--body', args.body || ''];
+                    if (args.labels && Array.isArray(args.labels) && args.labels.length > 0) {
+                        cmd.push('--label', args.labels.join(','));
+                    }
+                    if (args.assignees && Array.isArray(args.assignees) && args.assignees.length > 0) {
+                        cmd.push('--assignee', args.assignees.join(','));
+                    }
+                    const res = await executor.run(cmd, { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: 'Issue 创建成功', url: res.rawOutput };
+                }
+                case 'comment': {
+                    if (!args.issue_number || !args.body)
+                        throw new Error('comment 必须提供 issue_number 和 body');
+                    const res = await executor.run(['issue', 'comment', String(args.issue_number), ...repoArgs, '--body', args.body], { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: '评论发布成功', output: res.rawOutput };
+                }
+                case 'close': {
+                    if (!args.issue_number)
+                        throw new Error('close 操作必须提供 issue_number');
+                    const res = await executor.run(['issue', 'close', String(args.issue_number), ...repoArgs], { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `Issue #${args.issue_number} 已成功关闭` };
+                }
+                case 'reopen': {
+                    if (!args.issue_number)
+                        throw new Error('reopen 操作必须提供 issue_number');
+                    const res = await executor.run(['issue', 'reopen', String(args.issue_number), ...repoArgs], { cwd });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `Issue #${args.issue_number} 已重新开启` };
+                }
+                default:
+                    throw new Error(`未知的 Issue 操作: ${args.action}`);
+            }
+        },
+    });
+}

package/lib/tools/pr.d.ts

@@ -0,0 +1,2 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createPrTool(executor: GhExecutor): any;