dsh-github-flow 0.4.0 → 0.5.0

package/lib/tools/discussion.js

@@ -0,0 +1,195 @@
+import { renderDiscussionMarkdown } from '../renderers/markdown.js';
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
+const DISCUSSION_LIST_FIELDS = 'number,title,body,category,author,closed,createdAt,updatedAt,url,labels,answered,stateReason';
+const DISCUSSION_VIEW_FIELDS = 'number,title,body,category,author,state,createdAt,updatedAt,url,labels,answered,comments';
+export function createDiscussionTool(executor) {
+    return {
+        name: 'github_discussion',
+        description: '管理 GitHub Discussions 讨论区：浏览社区讨论、检视讨论详情与回复楼层、发起新讨论议题、编辑现有讨论以及追加评论回复。基于 gh CLI preview 特性。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'view', 'create', 'edit', 'comment'],
+                    description: 'Discussion 操作类型。list 查阅讨论列表、view 查看正文与评论、create 发起新讨论、edit 修改讨论、comment 发表评论。',
+                },
+                repo: {
+                    type: 'string',
+                    description: '目标仓库 [owner/repo]，留空则识别当前工作区仓库。',
+                },
+                discussion_number: {
+                    type: 'number',
+                    description: '讨论编号（view, edit, comment 动作必需，如 123）。',
+                },
+                title: {
+                    type: 'string',
+                    description: '讨论标题（create 动作必需，edit 动作修改标题时可选）。',
+                },
+                body: {
+                    type: 'string',
+                    description: '讨论正文或评论正文（create, comment 必需，edit 动作修改正文时可选）。',
+                },
+                category: {
+                    type: 'string',
+                    description: '讨论分类名称（create 动作必需，list 动作按分类筛选使用，如 "General"、"Q&A"、"Ideas"）。',
+                },
+                state: {
+                    type: 'string',
+                    enum: ['open', 'closed', 'all'],
+                    description: '讨论状态过滤（list 动作使用，默认 open）。',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '按标签筛选（list 动作使用）。',
+                },
+                search: {
+                    type: 'string',
+                    description: '搜索过滤关键词（list 动作使用，映射 -S/--search）。',
+                },
+                comments: {
+                    type: 'boolean',
+                    description: '是否一并拉取评论列表（view 动作使用，默认 true）。',
+                },
+                limit: {
+                    type: 'number',
+                    description: '返回讨论数量上限（list 动作使用，默认 30）。',
+                },
+            },
+            required: ['action'],
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: renderDiscussionMarkdown(args, value) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            const runOpts = { cwd, sessionId };
+            switch (args.action) {
+                case 'list': {
+                    const limit = typeof args.limit === 'number' && args.limit > 0 ? Math.min(args.limit, 100) : 30;
+                    const listCmd = [
+                        'discussion', 'list',
+                        '-L', String(limit),
+                        '--json', DISCUSSION_LIST_FIELDS,
+                        ...repoArgs,
+                    ];
+                    if (args.category)
+                        listCmd.push('-c', String(args.category).trim());
+                    if (args.state)
+                        listCmd.push('-s', args.state);
+                    if (args.search)
+                        listCmd.push('-S', String(args.search).trim());
+                    if (Array.isArray(args.labels) && args.labels.length > 0) {
+                        args.labels.forEach((l) => {
+                            if (l)
+                                listCmd.push('-l', String(l).trim());
+                        });
+                    }
+                    const res = await executor.run(listCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return normalizeOutput(res.data || res.rawOutput);
+                }
+                case 'view': {
+                    if (!args.discussion_number || typeof args.discussion_number !== 'number') {
+                        throw new Error('view 操作必须提供 discussion_number（讨论数字编号），以防止进入交互式挂起');
+                    }
+                    const numStr = String(args.discussion_number);
+                    const viewCmd = [
+                        'discussion', 'view', numStr,
+                        '--json', DISCUSSION_VIEW_FIELDS,
+                        ...repoArgs,
+                    ];
+                    if (args.comments !== false) {
+                        viewCmd.push('-c');
+                    }
+                    const res = await executor.run(viewCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return normalizeOutput(res.data || res.rawOutput);
+                }
+                case 'create': {
+                    if (!args.title || typeof args.title !== 'string' || !args.title.trim()) {
+                        throw new Error('create 操作必须提供 title（讨论标题）');
+                    }
+                    if (!args.body || typeof args.body !== 'string' || !args.body.trim()) {
+                        throw new Error('create 操作必须提供 body（讨论正文）');
+                    }
+                    if (!args.category || typeof args.category !== 'string' || !args.category.trim()) {
+                        throw new Error('create 操作必须提供 category（讨论分类，例如 "General"、"Q&A"、"Ideas"）');
+                    }
+                    const createCmd = [
+                        'discussion', 'create',
+                        '-t', args.title.trim(),
+                        '-b', args.body.trim(),
+                        '-c', args.category.trim(),
+                        ...repoArgs,
+                    ];
+                    const res = await executor.run(createCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return {
+                        message: '讨论已成功发起',
+                        url: res.rawOutput ? res.rawOutput.trim() : undefined,
+                    };
+                }
+                case 'edit': {
+                    if (!args.discussion_number || typeof args.discussion_number !== 'number') {
+                        throw new Error('edit 操作必须提供 discussion_number（讨论数字编号）');
+                    }
+                    if (!args.title && !args.body) {
+                        throw new Error('edit 操作至少需提供 title 或 body 中的一项进行修改');
+                    }
+                    const editCmd = ['discussion', 'edit', String(args.discussion_number), ...repoArgs];
+                    if (args.title)
+                        editCmd.push('-t', String(args.title).trim());
+                    if (args.body)
+                        editCmd.push('-b', String(args.body).trim());
+                    const res = await executor.run(editCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return {
+                        message: `讨论 #${args.discussion_number} 已更新成功`,
+                        output: res.rawOutput || 'Updated',
+                    };
+                }
+                case 'comment': {
+                    if (!args.discussion_number || typeof args.discussion_number !== 'number') {
+                        throw new Error('comment 操作必须提供 discussion_number（讨论数字编号）');
+                    }
+                    if (!args.body || typeof args.body !== 'string' || !args.body.trim()) {
+                        throw new Error('comment 操作必须提供 body（评论正文）');
+                    }
+                    const commentCmd = [
+                        'discussion', 'comment', String(args.discussion_number),
+                        '-b', args.body.trim(),
+                        ...repoArgs,
+                    ];
+                    const res = await executor.run(commentCmd, { ...runOpts, rawText: true, timeoutMs: 60_000 });
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return {
+                        message: `已向讨论 #${args.discussion_number} 成功发表评论`,
+                        url: res.rawOutput ? res.rawOutput.trim() : undefined,
+                    };
+                }
+                default:
+                    throw new Error(`未知的 Discussion 操作: ${args.action}`);
+            }
+        },
+    };
+}

package/lib/tools/help.js

@@ -18,9 +18,14 @@ const KNOWLEDGE_BASE = {
 | \`github_cache\` | Actions 构建缓存盘点与安全清理 | 查看缓存列表与体积占用、按 ID/Key 删除指定缓存、全量清空缓存（需 confirm） |
 | \`github_gist\` | 代码片段与调试日志分享治理 | 查看 Gist 列表与代码正文、创建 Secret/Public 代码片段、编辑与物理删除（需 confirm） |
 | \`github_status\` | 跨仓库待办与动态聚合看板 | 账号维度汇总指派给我的 Issue/PR、等待评审、被 @提及 以及订阅仓库近期动态 |
+| \`github_agent_task\` | 云端智能体编码任务会话治理 | 查阅已分派任务列表、检视任务状态与会话日志、向云端 Agent 发起新编码重构任务 |
+| \`github_discussion\` | 团队技术讨论与开源社区 RFC 闭环 | 浏览讨论列表、检视正文与评论楼层、发起新讨论、编辑正文与追加回复 |
+| \`github_project\` | Projects v2 项目看板与任务规划 | 查阅项目列表/详情、浏览看板条目 (Items)、添加 Issue/PR 到看板、创建草稿任务与删除条目 |
+| \`github_codespace\` | 云端远程开发环境管控 (MVP) | 查阅运行中实例、检视机器规格配置、停机防计费 (stop)、安全销毁环境 (delete，需 confirm) |
 | \`github_help\` | 路由导航、官方语法速查与故障自愈 | 遇到不确定的操作、搜索语法或接口报错时查询用法与诊断配方 |
 
 💡 **使用准则**：优先调用高层语义工具（pr / issue / run / repo / release / secret）；当高层工具无法满足特殊接口需求时，再降级使用 \`github_api\`。
+💬 **人类指令**：聊天框支持 \`/gh status\`（大盘看板）、\`/gh upgrade\`（一键升级插件）、\`/gh help\`（快捷帮助）。
 🗺️ **命令对照**：不确定某 gh 命令对应哪个工具？\`github_help(topic: 'mapping')\` 查询完整映射表（含未覆盖域的 API 引导）。`,
     pr: `### 🔀 github_pr 详细操作指南
 
@@ -155,6 +160,10 @@ const KNOWLEDGE_BASE = {
   - install 会写本地磁盘，必须 \`confirm: true\`；scope 默认 project（当前 git 仓库）。
   - 支持的 agent 值：claude-code / cursor / github-copilot / codex / gemini-cli 等。
 - **查看已安装**: \`github_skill(action: 'list')\`
+- **规范自检与发布**:
+  - \`github_skill(action: 'publish')\` —— 默认 \`--dry-run\` 模式，对本地技能目录进行 agentskills.io 合规性检查（命名规范、目录匹配、必需 frontmatter 字段等），零副作用安全自检。
+  - \`github_skill(action: 'publish', fix: true)\` —— 自动清洗并剥离残留的安装元数据（\`metadata.github-*\`），修改本地文件但不发布。
+  - \`github_skill(action: 'publish', tag: 'v1.0.0', dry_run: false, confirm: true)\` —— 正式发布，强制要求指定 \`tag\` 并附带 \`confirm: true\`（防无头挂起与误发布），自动创建 GitHub Release。
 - ⚠️ 若报「unknown command」，说明宿主机 gh 版本过低，需升级到 2.9x 以上。`,
     label: `### 🏷️ github_label 详细操作指南
 
@@ -210,7 +219,52 @@ const KNOWLEDGE_BASE = {
 - **限定组织**: \`github_status(org: 'my-org')\`
   - 仅汇报指定组织内部的待办事项与动态。
 - **排除噪音仓库**: \`github_status(exclude: ['owner/noisy-repo'])\`
-  - 过滤高频刷屏但无需关注的仓库活动。`,
+  - 过滤高频刷屏但无需关注的仓库活动。
+- **查看工具链运行时健康度**: \`github_status(action: 'health')\`
+  - 审计当前会话 18 大工具矩阵的综合健康分、API 降级率、安全防线拦截频次与针对性自愈建议。`,
+    agent_task: `### 🤖 github_agent_task 智能体任务指南
+
+管理与调度 GitHub Copilot Coding Agent 云端智能体会话：
+- **查看任务列表**: \`github_agent_task(action: 'list', limit: 30)\`
+  - 账号全局任务全景列表（注：上游 gh CLI 原生不接收 -R/--repo 限制，默认列出当前用户所有活跃会话）。
+- **检视任务会话与日志**: \`github_agent_task(action: 'view', task_id: 'e2fa49d2-...', log: true)\`
+  - 必须提供 \`task_id\`（支持 Session ID、PR 编号或 URL），支持 \`repo: 'owner/repo'\`，附加 \`log: true\` 可完整拉取任务执行过程日志。
+- **派发新编码任务**: \`github_agent_task(action: 'create', prompt: '为用户模块补全单元测试', base_branch: 'main', repo: 'owner/repo')\`
+  - 支持附加 \`custom_agent: 'my-agent'\` 指定仓库预设的智能体定义，支持 \`repo\` 定向派发。`,
+    discussion: `### 💬 github_discussion 讨论区操作指南
+
+基于 GitHub CLI 的 \`gh discussion\` preview 特性，支持团队架构探讨、RFC 与社区互动：
+- **查看讨论列表**: \`github_discussion(action: 'list', category: 'General', state: 'open', limit: 30)\`
+  - 支持按 \`category\`（分类）、\`state\`（open/closed/all）、\`labels\` 以及 \`search\`（关键词）过滤；状态自动结构化映射为 OPEN / CLOSED / ANSWERED。
+- **检视讨论正文与回复楼层**: \`github_discussion(action: 'view', discussion_number: 123, comments: true)\`
+- **发起新讨论**: \`github_discussion(action: 'create', title: 'RFC: 架构演进方案', category: 'Ideas', body: '详细方案...')\`
+  - \`title\`、\`category\` 与 \`body\` 均为必填项。
+- **编辑讨论**: \`github_discussion(action: 'edit', discussion_number: 123, title: '新标题', body: '修正后的正文')\`
+- **发表讨论回复**: \`github_discussion(action: 'comment', discussion_number: 123, body: '赞同该方案！')\`
+- 💡 **提示**：若报错「discussions disabled」，说明目标仓库未在 GitHub 仓库「Settings -> General -> Features」中启用 Discussions 社区功能。`,
+    project: `### 📋 github_project 项目看板与规划指南
+
+基于 GitHub Projects v2，支持项目看板与任务全生命周期管理：
+- **查看项目列表**: \`github_project(action: 'list', owner: '@me', closed: false)\`
+  - 缺省 owner 为 \`@me\`（当前用户），可指定组织或用户名称。
+- **查看项目详情**: \`github_project(action: 'view', project_number: 1)\`
+- **浏览看板条目 (Items)**: \`github_project(action: 'item-list', project_number: 1, query: 'is:open')\`
+- **添加现有 Issue/PR 到看板**: \`github_project(action: 'item-add', project_number: 1, url: 'https://github.com/owner/repo/issues/10')\`
+- **创建草稿条目**: \`github_project(action: 'item-create', project_number: 1, title: '待调研技术方案', body: '方案说明...')\`
+- **删除看板条目**: \`github_project(action: 'item-delete', item_id: 'PVTI_...', confirm: true)\`
+  - 必须附加 \`confirm: true\`；仅解除条目与看板的关联，不删除 Issue/PR 原型。
+- 🔑 若报缺少权限，在终端执行单行自愈授权命令：\`gh auth refresh -s read:project\``,
+    codespace: `### ☁️ github_codespace 云端开发环境指南
+
+管理 GitHub Codespaces 云端远程工作区（精选高频实用 MVP）：
+- **查看云端环境列表**: \`github_codespace(action: 'list', limit: 30)\`
+- **检视实例配置与状态**: \`github_codespace(action: 'view', codespace: 'fuzzy-spoon-69vj')\`
+  - 必须显式提供 \`codespace\` 名称，杜绝交互式挂起。
+- **停止运行环境 (防计费)**: \`github_codespace(action: 'stop', codespace: 'fuzzy-spoon-69vj')\`
+  - 立即向云端实例发送停机信号，防止持续扣除计算核时配额。
+- **安全销毁实例**: \`github_codespace(action: 'delete', codespace: 'fuzzy-spoon-69vj', confirm: true)\`
+  - 物理销毁不可逆，必须附加 \`confirm: true\`。
+- 🔑 若报缺少权限，在终端执行单行自愈授权命令：\`gh auth refresh -h github.com -s codespace\``,
     mapping: `### 🗺️ gh 命令 ↔ 插件工具映射总表
 
 #### 一、已覆盖域映射（语义化 action 精确对照）
@@ -271,8 +325,8 @@ const KNOWLEDGE_BASE = {
 | \`gh variable list/set/get/delete\` | \`github_secret(action:…, kind:'variable')\` | CI 明文：-b 直传、get 可回显 |
 | （gh secret get 不存在） | — | GitHub 侧加密存储，物理不可读取 |
 
-**Skill（github_skill，4 action）**
-\`gh skill search/preview/install/list\` → \`github_skill(action:…)\`；install 需 confirm（写磁盘）。
+**Skill（github_skill，5 action）**
+\`gh skill search/preview/install/list/publish\` → \`github_skill(action:…)\`；install 需 confirm（写磁盘）；publish 默认 dry-run 安全自检，正式发布需 tag 与 confirm。
 
 **Label（github_label，5 action）**
 | gh 命令 | 插件调用 | 备注 |
@@ -304,10 +358,45 @@ const KNOWLEDGE_BASE = {
 | \`gh gist edit\` | \`github_gist(action:'edit', gist_id:…)\` | 描述与文件修改 |
 | \`gh gist delete\` | \`github_gist(action:'delete', gist_id:…, confirm:true)\` | 物理删除，需 confirm |
 
-**Status（github_status，账号维度聚合面板）**
+**Status（github_status，2 action）**
 | gh 命令 | 插件调用 | 备注 |
 | :--- | :--- | :--- |
 | \`gh status\` | \`github_status(action:'view')\` | 跨仓待办大盘与动态 |
+| — | \`github_status(action:'health')\` | 工具链健康度与降级率审计 |
+
+**Agent Task（github_agent_task，3 action）**
+| gh 命令 | 插件调用 | 备注 |
+| :--- | :--- | :--- |
+| \`gh agent-task list\` | \`github_agent_task(action:'list')\` | 智能体编码任务列表 |
+| \`gh agent-task view\` | \`github_agent_task(action:'view', task_id:…)\` | 任务状态与日志，ID 必填 |
+| \`gh agent-task create\` | \`github_agent_task(action:'create', prompt:…)\` | 向云端 Agent 派发任务 |
+
+**Discussion（github_discussion，5 action）**
+| gh 命令 | 插件调用 | 备注 |
+| :--- | :--- | :--- |
+| \`gh discussion list\` | \`github_discussion(action:'list')\` | 社区与团队讨论列表 |
+| \`gh discussion view\` | \`github_discussion(action:'view', discussion_number:…)\` | 讨论正文与回复楼层 |
+| \`gh discussion create\` | \`github_discussion(action:'create', title:…, category:…, body:…)\` | 发起新讨论，三项必填 |
+| \`gh discussion edit\` | \`github_discussion(action:'edit', discussion_number:…)\` | 修改讨论标题或正文 |
+| \`gh discussion comment\` | \`github_discussion(action:'comment', discussion_number:…, body:…)\` | 追加讨论评论 |
+
+**Project（github_project，6 action）**
+| gh 命令 | 插件调用 | 备注 |
+| :--- | :--- | :--- |
+| \`gh project list\` | \`github_project(action:'list')\` | 项目看板列表，默认 @me |
+| \`gh project view\` | \`github_project(action:'view', project_number:…)\` | 项目元数据与描述 |
+| \`gh project item-list\` | \`github_project(action:'item-list', project_number:…)\` | 任务条目看板 |
+| \`gh project item-add\` | \`github_project(action:'item-add', project_number:…, url:…)\` | 关联 Issue/PR 到看板 |
+| \`gh project item-create\` | \`github_project(action:'item-create', project_number:…, title:…)\` | 创建草稿条目 |
+| \`gh project item-delete\` | \`github_project(action:'item-delete', item_id:…, confirm:true)\` | 移除条目，需 confirm |
+
+**Codespace（github_codespace，4 action）**
+| gh 命令 | 插件调用 | 备注 |
+| :--- | :--- | :--- |
+| \`gh codespace list\` | \`github_codespace(action:'list')\` | 云端开发环境列表 |
+| \`gh codespace view\` | \`github_codespace(action:'view', codespace:…)\` | 实例详情，名称必填 |
+| \`gh codespace stop\` | \`github_codespace(action:'stop', codespace:…)\` | 关机防计费 |
+| \`gh codespace delete\` | \`github_codespace(action:'delete', codespace:…, confirm:true)\` | 销毁实例，需 confirm |
 
 #### 二、归属提示（命令域与工具名不同构）
 
@@ -320,14 +409,10 @@ const KNOWLEDGE_BASE = {
 
 | gh 域 | 用途 | 推荐 REST 端点 |
 | :--- | :--- | :--- |
-| \`gh project\` | Projects v2 | \`graphql\`（Projects API 仅 GraphQL） |
-| \`gh discussion\` | 讨论 | \`graphql\`（需仓库开启 discussions） |
-| \`gh codespace\` | 云端开发环境 | \`user/codespaces\` |
 | \`gh org\` | 组织信息 | \`orgs/{org}\` |
 | \`gh auth/config/extension/alias\` | 本机配置类 | 多数无需 API（本机文件/命令） |
 | \`gh browse\` | 打开浏览器 | 直接给用户 URL 即可 |
 | \`gh attestation/gpg-key/ssh-key\` | 签名与密钥 | \`repos/{o}/{r}/attestations\` 等 |
-| \`gh agent-task\` | Copilot 会话 | \`graphql\`（需 Copilot 授权） |
 
 > 用法示例：\`github_api(endpoint: 'repos/owner/repo/pulls')\`（原有 \`repos/{o}/{r}/labels\` 端点已由原生 \`github_label\` 工具接管）`,
     search_syntax: `### 🔍 GitHub 官方高级检索语法速查手册
@@ -361,7 +446,18 @@ const KNOWLEDGE_BASE = {
    - *解法*：宿主机尚未安装 gh。Windows 运行 \`winget install GitHub.cli\`，macOS 运行 \`brew install gh\`，然后执行 \`gh auth login\` 登录。
  5. **报 \`unknown command "skill" for "gh"\`**:
     - *原因*：\`gh skill\` 是 GitHub CLI 2.9x 引入的 preview 特性，宿主机版本过低。
-    - *解法*：升级 gh（Windows: \`winget upgrade GitHub.cli\`；macOS: \`brew upgrade gh\`）后重试；升级前可改用 \`github_api\` 检索 \`SKILL.md\` 文件路径作为替代。`
+    - *解法*：升级 gh（Windows: \`winget upgrade GitHub.cli\`；macOS: \`brew upgrade gh\`）后重试；升级前可改用 \`github_api\` 检索 \`SKILL.md\` 文件路径作为替代。
+ 6. **报 \`the token ... needs the '<scope>' scope\` (缺少权限)**:
+    - *原因*：GitHub Token 缺少对应操作的最小 Scope 权限（如 Codespaces 需要 \`codespace\` 权限，Projects v2 需要 \`read:project\` 权限）。
+    - *解法*：在系统终端执行单行自愈命令完成授权刷新（无需重启插件，即刻生效）：
+      - Codespace: \`gh auth refresh -h github.com -s codespace\`
+      - Project: \`gh auth refresh -s read:project\`
+ 7. **报 \`the '...' repository has discussions disabled\`**:
+    - *原因*：目标 GitHub 仓库未开启 Discussions 社区功能。
+    - *解法*：需管理员前往 GitHub 网页端 \`Settings -> General -> Features\` 勾选开启 \`Discussions\`。
+ 8. **操作被拦截提示 \`Awaiting confirmation\`**:
+    - *原因*：对于高危破坏性操作（如合并 PR、删除分支、物理删除 Issue、清空构建缓存、删除密钥、销毁 Codespace），插件设置了强制安全确认防线，未确认时绝对不触发底层 CLI。
+    - *解法*：审阅影响评估报告后，在参数中显式传入 \`confirm: true\` 即可放行。`
 };
 export function createHelpTool(executor) {
     return {
@@ -387,6 +483,10 @@ export function createHelpTool(executor) {
                         'cache',
                         'gist',
                         'status',
+                        'agent_task',
+                        'discussion',
+                        'project',
+                        'codespace',
                         'mapping',
                         'search_syntax',
                         'troubleshooting',

package/lib/tools/project.d.ts

@@ -0,0 +1,80 @@
+import type { GhExecutor } from '../executor.js';
+/**
+ * 检测错误信息是否属于 Scope 权限不足，并返回标准自愈对象
+ */
+export declare function checkScopeRequired(errorMsg: string, scope: string, command: string, tool: string): {
+    status: string;
+    scope: string;
+    command: string;
+    tool: string;
+} | null;
+export declare function createProjectTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            owner: {
+                type: string;
+                description: string;
+            };
+            project_number: {
+                type: string;
+                description: string;
+            };
+            item_id: {
+                type: string;
+                description: string;
+            };
+            url: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            closed: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<Record<string, any> | {
+        status: string;
+        scope: string;
+        command: string;
+        tool: string;
+    }>;
+};