@zhin.js/adapter-github 1.1.0 → 1.1.3

package/{agent/tools/unbind.ts → agents/github/skills/github-account/tools/unbind/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubUnbind } from '../../src/github-tool-handlers.js';
+import { executeGithubUnbind } from '../../handlers.js';
 
 export default defineAgentTool<{}>({
   description: '解除你绑定的 GitHub 账号',
@@ -8,6 +8,6 @@ export default defineAgentTool<{}>({
   inputSchema: z.object({}),
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubUnbind({}, context.$client, context.message);
+    return executeGithubUnbind({}, context.$client);
   },
 });

package/agents/github/skills/github-account/tools/whoami/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubWhoami } from '../../handlers.js';
+export default defineAgentTool({
+    description: '查看你绑定的 GitHub 账号信息',
+    adapter: 'github',
+    inputSchema: z.object({}),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubWhoami({}, context.$client);
+    },
+});

package/{agent/tools/whoami.ts → agents/github/skills/github-account/tools/whoami/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubWhoami } from '../../src/github-tool-handlers.js';
+import { executeGithubWhoami } from '../../handlers.js';
 
 export default defineAgentTool<{}>({
   description: '查看你绑定的 GitHub 账号信息',
@@ -8,6 +8,6 @@ export default defineAgentTool<{}>({
   inputSchema: z.object({}),
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubWhoami({}, context.$client, context.message);
+    return executeGithubWhoami({}, context.$client);
   },
 });

package/agents/github/skills/github-cli/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: github-cli
+platforms:
+  - github
+description: 使用 gh CLI 处理内置 GitHub Tool 未覆盖的 Issue、PR、Release、Workflow、搜索和 API 操作。
+keywords:
+  - "github"
+  - "gh"
+  - "issue"
+  - "pull request"
+  - "release"
+  - "workflow"
+  - "search"
+  - "api"
+---
+
+# GitHub CLI
+
+只有内置 GitHub Skill 不覆盖任务时才加载本 Skill。当前进程通过 `GH_TOKEN` 提供 gh CLI 身份；先执行 `gh auth status` 核对身份和权限。仓库参数统一使用 `owner/repo`。
+
+## 常用命令
+
+```bash
+gh issue list -R owner/repo --state open --limit 20 --json number,title,state,labels,assignees
+gh issue view 123 -R owner/repo --json number,title,body,state,labels,assignees
+gh issue create -R owner/repo --title "标题" --body "正文"
+gh pr list -R owner/repo --state open --limit 20 --json number,title,state,author,mergeable
+gh pr view 456 -R owner/repo --json number,title,body,state,author,mergeable,reviewDecision
+gh pr checks 456 -R owner/repo
+gh pr diff 456 -R owner/repo
+gh release list -R owner/repo --limit 10
+gh run list -R owner/repo --limit 10 --json databaseId,displayTitle,status,conclusion
+gh workflow list -R owner/repo
+gh search issues "关键词" --repo owner/repo --limit 10 --json number,title,state
+gh search code "函数名" --repo owner/repo --limit 10 --json path,textMatches
+```
+
+需要其他 API 时使用 `gh api` 或 `gh api graphql`。任何创建、修改、合并、关闭、重跑或发布操作都属于外部副作用，必须遵守执行工具的审批策略。
+
+## 输出控制
+
+- 列表必须使用 `--limit`，默认不超过 20 条。
+- 使用 `--json` 与 `--jq` 只保留任务需要的字段。
+- 正文最多读取 2000 字符，diff 最多读取 200 行。
+- 单次调用输出应小于 15KB。
+
+遇到 401 检查身份与 Token；404 同时检查资源存在性和权限；422 检查必填参数。不要把命令失败推断成资源不存在。

package/agents/github/skills/github-repository/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: github-repository
+platforms:
+  - github
+description: GitHub 工作区准备、文件补丁、分支推送和 PR 创建能力。
+keywords:
+  - "github"
+  - "repository"
+  - "patch"
+  - "branch"
+  - "pull request"
+tools:
+  - "prepare_workspace"
+  - "patch_file"
+  - "create_pr"
+  - "push_branch"
+---
+
+# github-repository
+
+这些 Tool 使用 GitHub App Installation Token，以 Bot 身份写仓库。按 `prepare_workspace`、`patch_file`、`push_branch`、`create_pr` 的顺序操作，每一步使用上一步返回的稳定引用。Issue 线程创建新分支后开 PR；PR 线程推送到现有 head 分支。不要改用人身份 PAT 的 MCP 工具完成 Bot 写入。推送和创建 PR 前复核仓库、base/head 分支与变更内容，并遵守 HITL 审批。

package/{lib/github-bot-handlers.js → agents/github/skills/github-repository/handlers.js}

@@ -1,5 +1,6 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
-import { parseMessageChannel, resolveWorkspaceBranch, formatChannelContext, } from './github-channel-context.js';
+import { formatChannelContext, parseMessageChannel, resolveWorkspaceBranch, } from "../../../../lib/github-channel-context.js";
 function requireBotGh(client) {
     const gh = client.api;
     if (!gh?.isAppAuth) {

package/{src/github-bot-handlers.ts → agents/github/skills/github-repository/handlers.ts}

@@ -3,12 +3,12 @@
  */
 import type { Message } from 'zhin.js';
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
-import type { GithubClient } from './client.js';
 import {
+  formatChannelContext,
   parseMessageChannel,
   resolveWorkspaceBranch,
-  formatChannelContext,
-} from './github-channel-context.js';
+} from '../../../../src/github-channel-context.js';
+import type { GithubClient } from '../../../../src/client.js';
 
 function requireBotGh(client: GithubClient) {
   const gh = client.api;

package/agents/github/skills/github-repository/tools/create_pr/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubCreatePr } from '../../handlers.js';
+export default defineAgentTool({
+    description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        title: z.string().describe('PR 标题'),
+        body: z.string().optional().describe('PR 正文'),
+        head: z.string().optional().describe('head 分支，缺省为工作区分支'),
+        base: z.string().optional().describe('base 分支，缺省为仓库默认分支'),
+    }),
+    tags: ['github'],
+    requiresApproval: 'always',
+    async execute(input, context) {
+        return executeGithubCreatePr(input, context.$client);
+    },
+});

package/{agent/tools/create_pr.ts → agents/github/skills/github-repository/tools/create_pr/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubCreatePr } from '../../src/github-bot-handlers.js';
+import { executeGithubCreatePr } from '../../handlers.js';
 
 export default defineAgentTool<{ repo?: string; title: string; body?: string; head?: string; base?: string }>({
   description: '以 GitHub App Bot 身份创建 Pull Request（需 HITL 确认；Issue 场景常用）',
@@ -13,8 +13,8 @@ export default defineAgentTool<{ repo?: string; title: string; body?: string; he
     base: z.string().optional().describe('base 分支，缺省为仓库默认分支'),
   }),
   tags: ['github'],
-  approval: 'always',
+  requiresApproval: 'always',
   async execute(input, context) {
-    return executeGithubCreatePr(input, context.$client, context.message);
+    return executeGithubCreatePr(input, context.$client);
   },
 });

package/agents/github/skills/github-repository/tools/patch_file/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPatchFile } from '../../handlers.js';
+export default defineAgentTool({
+    description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        path: z.string().describe('仓库内文件路径'),
+        content: z.string().describe('新文件内容'),
+        message: z.string().describe('commit message'),
+        branch: z.string().optional().describe('目标分支，缺省从 Issue/PR 上下文推断'),
+    }),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubPatchFile(input, context.$client);
+    },
+});

package/{agent/tools/patch_file.ts → agents/github/skills/github-repository/tools/patch_file/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubPatchFile } from '../../src/github-bot-handlers.js';
+import { executeGithubPatchFile } from '../../handlers.js';
 
 export default defineAgentTool<{ repo?: string; path: string; content: string; message: string; branch?: string }>({
   description: '通过 Contents API 单文件更新（小改；Bot Installation Token 身份）',
@@ -14,6 +14,6 @@ export default defineAgentTool<{ repo?: string; path: string; content: string; m
   }),
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubPatchFile(input, context.$client, context.message);
+    return executeGithubPatchFile(input, context.$client);
   },
 });

package/agents/github/skills/github-repository/tools/prepare_workspace/index.js

@@ -0,0 +1,15 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPrepareWorkspace } from '../../handlers.js';
+export default defineAgentTool({
+    description: 'Clone/fetch 托管工作区并 checkout 到 Issue/PR 对应分支（GitHub App Bot 身份）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo，缺省从当前 Issue/PR 频道推断'),
+    }),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubPrepareWorkspace(input, context.$client);
+    },
+});

package/{agent/tools/prepare_workspace.ts → agents/github/skills/github-repository/tools/prepare_workspace/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubPrepareWorkspace } from '../../src/github-bot-handlers.js';
+import { executeGithubPrepareWorkspace } from '../../handlers.js';
 
 export default defineAgentTool<{ repo?: string }>({
   description: 'Clone/fetch 托管工作区并 checkout 到 Issue/PR 对应分支（GitHub App Bot 身份）',
@@ -10,6 +10,6 @@ export default defineAgentTool<{ repo?: string }>({
   }),
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubPrepareWorkspace(input, context.$client, context.message);
+    return executeGithubPrepareWorkspace(input, context.$client);
   },
 });

package/agents/github/skills/github-repository/tools/push_branch/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubPushBranch } from '../../handlers.js';
+export default defineAgentTool({
+    description: '在托管工作区 git commit 并 push 到远程分支（需 HITL 确认；Bot 身份）',
+    adapter: 'github',
+    inputSchema: z.object({
+        repo: z.string().optional().describe('owner/repo'),
+        branch: z.string().optional().describe('分支名，缺省从上下文推断'),
+        message: z.string().describe('commit message'),
+    }),
+    tags: ['github'],
+    requiresApproval: 'always',
+    async execute(input, context) {
+        return executeGithubPushBranch(input, context.$client);
+    },
+});

package/{agent/tools/push_branch.ts → agents/github/skills/github-repository/tools/push_branch/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubPushBranch } from '../../src/github-bot-handlers.js';
+import { executeGithubPushBranch } from '../../handlers.js';
 
 export default defineAgentTool<{ repo?: string; branch?: string; message: string }>({
   description: '在托管工作区 git commit 并 push 到远程分支（需 HITL 确认；Bot 身份）',
@@ -11,8 +11,8 @@ export default defineAgentTool<{ repo?: string; branch?: string; message: string
     message: z.string().describe('commit message'),
   }),
   tags: ['github'],
-  approval: 'always',
+  requiresApproval: 'always',
   async execute(input, context) {
-    return executeGithubPushBranch(input, context.$client, context.message);
+    return executeGithubPushBranch(input, context.$client);
   },
 });

package/agents/github/skills/github-subscriptions/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: github-subscriptions
+platforms:
+  - github
+description: GitHub Star 与仓库订阅管理能力。
+keywords:
+  - "github"
+  - "star"
+  - "订阅"
+  - "通知"
+tools:
+  - "star"
+  - "subscribe"
+  - "subscriptions"
+  - "unsubscribe"
+---
+
+# github-subscriptions
+
+先用 `subscriptions` 查询当前聊天通道的已有订阅，再执行订阅或取消。Webhook 订阅绑定当前聊天通道，只会向该通道投递事件。`star` 优先使用用户绑定的 OAuth 身份，未绑定时才使用 Endpoint 默认身份；外部写操作遵守审批策略。

package/agents/github/skills/github-subscriptions/handlers.js

@@ -0,0 +1,101 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { getCurrentCommMessage } from '@zhin.js/agent/security';
+function subscriptionsModel(client) {
+    const db = client.database;
+    return db?.models?.get('github_subscriptions');
+}
+export async function executeGithubStar(args, client, commMessage) {
+    const msg = commMessage ?? getCurrentCommMessage();
+    const gh = await client.getUserOrDefaultApi(msg?.$adapter, msg?.$sender.id);
+    switch (args.action) {
+        case 'star': {
+            const r = await gh.starRepo(args.repo);
+            return r.ok ? `⭐ 已 Star ${args.repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+        }
+        case 'unstar': {
+            const r = await gh.unstarRepo(args.repo);
+            return r.ok ? `💔 已取消 Star ${args.repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+        }
+        case 'check': {
+            const starred = await gh.isStarred(args.repo);
+            return starred ? `⭐ 已 Star ${args.repo}` : `☆ 尚未 Star ${args.repo}`;
+        }
+        default:
+            return `❌ 未知操作: ${args.action}`;
+    }
+}
+export async function executeGithubSubscribe(args, client, commMessage) {
+    const msg = commMessage ?? getCurrentCommMessage();
+    if (!msg?.$adapter || !msg?.$sender.id || !msg?.$channel?.id || !msg?.$endpoint) {
+        return '❌ 无法获取当前聊天通道信息';
+    }
+    const model = subscriptionsModel(client);
+    if (!model)
+        return '❌ 数据库未就绪';
+    const validEvents = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
+    const events = args.events
+        ? args.events.split(',').map((s) => s.trim()).filter((e) => validEvents.includes(e))
+        : validEvents;
+    if (!events.length)
+        return `❌ 无效的事件类型，可选: ${validEvents.join(', ')}`;
+    const [existing] = await model.select().where({
+        repo: args.repo,
+        target_id: msg.$channel?.id,
+        adapter: msg.$adapter,
+        endpoint: msg.$endpoint,
+    });
+    if (existing) {
+        await model.update({ events, target_type: msg.$channel?.type || 'private' }).where({ id: existing.id });
+        return `✅ 已更新订阅 ${args.repo}\n📡 事件: ${events.join(', ')}`;
+    }
+    await model.insert({
+        id: Date.now(),
+        repo: args.repo,
+        events,
+        target_id: msg.$channel?.id,
+        target_type: msg.$channel?.type || 'private',
+        adapter: msg.$adapter,
+        endpoint: msg.$endpoint,
+    });
+    return `✅ 已订阅 ${args.repo}\n📡 事件: ${events.join(', ')}\n📌 通知将推送到当前通道`;
+}
+export async function executeGithubUnsubscribe(args, client, commMessage) {
+    const msg = commMessage ?? getCurrentCommMessage();
+    if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
+        return '❌ 无法获取当前聊天通道信息';
+    }
+    const model = subscriptionsModel(client);
+    if (!model)
+        return '❌ 数据库未就绪';
+    const [existing] = await model.select().where({
+        repo: args.repo,
+        target_id: msg.$channel?.id,
+        adapter: msg.$adapter,
+        endpoint: msg.$endpoint,
+    });
+    if (!existing)
+        return `📭 当前通道未订阅 ${args.repo}`;
+    await model.delete().where({ id: existing.id });
+    return `✅ 已取消订阅 ${args.repo}`;
+}
+export async function executeGithubSubscriptions(_args, client, commMessage) {
+    const msg = commMessage ?? getCurrentCommMessage();
+    if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
+        return '❌ 无法获取当前聊天通道信息';
+    }
+    const model = subscriptionsModel(client);
+    if (!model)
+        return '❌ 数据库未就绪';
+    const subs = await model.select().where({
+        target_id: msg.$channel?.id,
+        adapter: msg.$adapter,
+        endpoint: msg.$endpoint,
+    });
+    if (!subs?.length)
+        return '📭 当前通道没有任何 GitHub 订阅';
+    return `📋 当前通道订阅 (${subs.length}):\n\n` +
+        subs.map((s) => {
+            const events = Array.isArray(s.events) ? s.events : [];
+            return `  📦 ${s.repo}\n     📡 ${events.join(', ') || '(无事件)'}`;
+        }).join('\n\n');
+}

package/agents/github/skills/github-subscriptions/handlers.ts

@@ -0,0 +1,119 @@
+import type { Message } from 'zhin.js';
+import { getCurrentCommMessage } from '@zhin.js/agent/security';
+import type { GithubClient } from '../../../../src/client.js';
+import type { EventType } from '../../../../src/types.js';
+
+function subscriptionsModel(client: GithubClient) {
+  const db = client.database as {
+    models?: Map<string, unknown>;
+  } | null | undefined;
+  return db?.models?.get('github_subscriptions') as {
+    select: () => { where: (q: object) => Promise<any[]> };
+    insert: (row: object) => Promise<void>;
+    update: (row: object) => { where: (q: object) => Promise<void> };
+    delete: () => { where: (q: object) => Promise<void> };
+  } | undefined;
+}
+
+export async function executeGithubStar(args: { action: 'star' | 'unstar' | 'check'; repo: string }, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  const gh = await client.getUserOrDefaultApi(msg?.$adapter, msg?.$sender.id);
+  switch (args.action) {
+    case 'star': {
+      const r = await gh.starRepo(args.repo);
+      return r.ok ? `⭐ 已 Star ${args.repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+    }
+    case 'unstar': {
+      const r = await gh.unstarRepo(args.repo);
+      return r.ok ? `💔 已取消 Star ${args.repo}` : `❌ ${r.data?.message || JSON.stringify(r.data)}`;
+    }
+    case 'check': {
+      const starred = await gh.isStarred(args.repo);
+      return starred ? `⭐ 已 Star ${args.repo}` : `☆ 尚未 Star ${args.repo}`;
+    }
+    default:
+      return `❌ 未知操作: ${args.action}`;
+  }
+}
+
+export async function executeGithubSubscribe(args: { repo: string; events?: string }, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$sender.id || !msg?.$channel?.id || !msg?.$endpoint) {
+    return '❌ 无法获取当前聊天通道信息';
+  }
+
+  const model = subscriptionsModel(client);
+  if (!model) return '❌ 数据库未就绪';
+
+  const validEvents: EventType[] = ['push', 'issue', 'star', 'fork', 'unstar', 'pull_request'];
+  const events: EventType[] = args.events
+    ? args.events.split(',').map((s) => s.trim()).filter((e): e is EventType => validEvents.includes(e as EventType))
+    : validEvents;
+  if (!events.length) return `❌ 无效的事件类型，可选: ${validEvents.join(', ')}`;
+
+  const [existing] = await model.select().where({
+    repo: args.repo,
+    target_id: msg.$channel?.id,
+    adapter: msg.$adapter,
+    endpoint: msg.$endpoint,
+  });
+  if (existing) {
+    await model.update({ events, target_type: msg.$channel?.type || 'private' }).where({ id: existing.id });
+    return `✅ 已更新订阅 ${args.repo}\n📡 事件: ${events.join(', ')}`;
+  }
+
+  await model.insert({
+    id: Date.now(),
+    repo: args.repo,
+    events,
+    target_id: msg.$channel?.id,
+    target_type: msg.$channel?.type || 'private',
+    adapter: msg.$adapter,
+    endpoint: msg.$endpoint,
+  });
+  return `✅ 已订阅 ${args.repo}\n📡 事件: ${events.join(', ')}\n📌 通知将推送到当前通道`;
+}
+
+export async function executeGithubUnsubscribe(args: { repo: string }, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
+    return '❌ 无法获取当前聊天通道信息';
+  }
+
+  const model = subscriptionsModel(client);
+  if (!model) return '❌ 数据库未就绪';
+
+  const [existing] = await model.select().where({
+    repo: args.repo,
+    target_id: msg.$channel?.id,
+    adapter: msg.$adapter,
+    endpoint: msg.$endpoint,
+  });
+  if (!existing) return `📭 当前通道未订阅 ${args.repo}`;
+
+  await model.delete().where({ id: existing.id });
+  return `✅ 已取消订阅 ${args.repo}`;
+}
+
+export async function executeGithubSubscriptions(_args: Record<string, never>, client: GithubClient, commMessage?: Message) {
+  const msg = commMessage ?? getCurrentCommMessage();
+  if (!msg?.$adapter || !msg?.$channel?.id || !msg?.$endpoint) {
+    return '❌ 无法获取当前聊天通道信息';
+  }
+
+  const model = subscriptionsModel(client);
+  if (!model) return '❌ 数据库未就绪';
+
+  const subs = await model.select().where({
+    target_id: msg.$channel?.id,
+    adapter: msg.$adapter,
+    endpoint: msg.$endpoint,
+  });
+  if (!subs?.length) return '📭 当前通道没有任何 GitHub 订阅';
+
+  return `📋 当前通道订阅 (${subs.length}):\n\n` +
+    subs.map((s: any) => {
+      const events = Array.isArray(s.events) ? s.events : [];
+      return `  📦 ${s.repo}\n     📡 ${events.join(', ') || '(无事件)'}`;
+    }).join('\n\n');
+}

package/agents/github/skills/github-subscriptions/tools/star/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubStar } from '../../handlers.js';
+export default defineAgentTool({
+    description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
+    adapter: 'github',
+    inputSchema: z.object({
+        action: z.enum(['star', 'unstar', 'check']),
+        repo: z.string().min(1),
+    }),
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubStar(input, context.$client);
+    },
+});

package/{agent/tools/star.ts → agents/github/skills/github-subscriptions/tools/star/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubStar } from '../../src/github-tool-handlers.js';
+import { executeGithubStar } from '../../handlers.js';
 
 export default defineAgentTool<{ action: 'star' | 'unstar' | 'check'; repo: string }>({
   description: 'Star 或取消 Star 一个 GitHub 仓库（使用你绑定的 GitHub 账号，未绑定则用 Endpoint 默认账号）',
@@ -11,6 +11,6 @@ export default defineAgentTool<{ action: 'star' | 'unstar' | 'check'; repo: stri
   }),
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubStar(input, context.$client, context.message);
+    return executeGithubStar(input, context.$client);
   },
 });

package/agents/github/skills/github-subscriptions/tools/subscribe/index.js

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubSubscribe } from '../../handlers.js';
+export default defineAgentTool({
+    description: '订阅 GitHub 仓库的 Webhook 事件，事件将推送到当前聊天通道',
+    inputSchema: z.object({
+        repo: z.string().min(1),
+        events: z.string().optional(),
+    }),
+    adapter: 'github',
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubSubscribe(input, context.$client);
+    },
+});

package/{agent/tools/subscribe.ts → agents/github/skills/github-subscriptions/tools/subscribe/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubSubscribe } from '../../src/github-tool-handlers.js';
+import { executeGithubSubscribe } from '../../handlers.js';
 
 export default defineAgentTool<{ repo: string; events?: string }>({
   description: '订阅 GitHub 仓库的 Webhook 事件，事件将推送到当前聊天通道',
@@ -11,6 +11,6 @@ export default defineAgentTool<{ repo: string; events?: string }>({
   adapter: 'github',
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubSubscribe(input, context.$client, context.message);
+    return executeGithubSubscribe(input, context.$client);
   },
 });

package/agents/github/skills/github-subscriptions/tools/subscriptions/index.js

@@ -0,0 +1,13 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { executeGithubSubscriptions } from '../../handlers.js';
+export default defineAgentTool({
+    description: '查看当前聊天通道的 GitHub 仓库订阅列表',
+    inputSchema: z.object({}),
+    adapter: 'github',
+    tags: ['github'],
+    async execute(input, context) {
+        return executeGithubSubscriptions({}, context.$client);
+    },
+});

package/{agent/tools/subscriptions.ts → agents/github/skills/github-subscriptions/tools/subscriptions/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { executeGithubSubscriptions } from '../../src/github-tool-handlers.js';
+import { executeGithubSubscriptions } from '../../handlers.js';
 
 export default defineAgentTool<{}>({
   description: '查看当前聊天通道的 GitHub 仓库订阅列表',
@@ -8,6 +8,6 @@ export default defineAgentTool<{}>({
   adapter: 'github',
   tags: ['github'],
   async execute(input, context) {
-    return executeGithubSubscriptions({}, context.$client, context.message);
+    return executeGithubSubscriptions({}, context.$client);
   },
 });