dsh-github-flow 0.4.0 → 0.6.0

package/lib/main.js

@@ -12,7 +12,12 @@ import { createRulesetTool } from './tools/ruleset.js';
 import { createCacheTool } from './tools/cache.js';
 import { createGistTool } from './tools/gist.js';
 import { createStatusTool } from './tools/status.js';
+import { createAgentTaskTool } from './tools/agent-task.js';
+import { createDiscussionTool } from './tools/discussion.js';
+import { createProjectTool } from './tools/project.js';
+import { createCodespaceTool } from './tools/codespace.js';
 import { createHelpTool } from './tools/help.js';
+import { defaultTelemetryCollector } from './telemetry.js';
 import { registerGhCommand } from './commands/gh.js';
 import { registerApiRoutes } from './api/routes.js';
 import { UpdateChecker } from './updater.js';
@@ -88,11 +93,26 @@ export function apply(ctx, config = {}) {
     else {
         ctx.github = executor;
     }
-    // 2. 注册人类 Slash 命令 (/gh status, /gh upgrade, /gh help)
+    // 2. 注册 Cordis tools/result 事件切面（无侵入全量工具审计与降级率打点）
+    if (ctx.on && typeof ctx.on === 'function') {
+        ctx.on('tools/result', (exec, result) => {
+            try {
+                const toolName = exec?.name || exec?.tool?.name || '';
+                if (typeof toolName === 'string' && toolName.startsWith('github_')) {
+                    const args = exec?.arguments || exec?.args || {};
+                    defaultTelemetryCollector.recordCall(toolName, args, result);
+                }
+            }
+            catch {
+                // Fail-Open 非阻塞防线：严禁打点逻辑异常影响主工具调用
+            }
+        });
+    }
+    // 3. 注册人类 Slash 命令 (/gh status, /gh upgrade, /gh help)
     if (ctx.commands) {
-        registerGhCommand(ctx.commands, executor, updateChecker);
+        registerGhCommand(ctx.commands, executor, updateChecker, defaultTelemetryCollector);
     }
-    // 3. 注册 Agent 模型工具集（核心领域工具 + 元指南）
+    // 4. 注册 Agent 模型工具集（核心领域工具 + 元指南）
     if (ctx.tools) {
         ctx.tools.register(createPrTool(executor));
         ctx.tools.register(createIssueTool(executor));
@@ -106,7 +126,11 @@ export function apply(ctx, config = {}) {
         ctx.tools.register(createRulesetTool(executor));
         ctx.tools.register(createCacheTool(executor));
         ctx.tools.register(createGistTool(executor));
-        ctx.tools.register(createStatusTool(executor));
+        ctx.tools.register(createStatusTool(executor, defaultTelemetryCollector));
+        ctx.tools.register(createAgentTaskTool(executor));
+        ctx.tools.register(createDiscussionTool(executor));
+        ctx.tools.register(createProjectTool(executor));
+        ctx.tools.register(createCodespaceTool(executor));
         ctx.tools.register(createHelpTool(executor));
     }
     // 4. 注册面向 Client 端的 WebServer HTTP 路由（如果当前环境启用了 Web UI 服务）

package/lib/renderers/agent-task.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Agent Task 状态徽标
+ */
+export declare function formatAgentTaskStateBadge(state?: string): string;
+/**
+ * 渲染 Agent Tasks 列表表格
+ */
+export declare function renderAgentTaskList(items: any[]): string;
+/**
+ * 渲染单个 Agent Task 详情卡片
+ */
+export declare function renderAgentTaskView(task: any): string;
+/**
+ * Agent Task 领域综合渲染入口
+ */
+export declare function renderAgentTaskMarkdown(args: any, value: any): string;

package/lib/renderers/agent-task.js

@@ -0,0 +1,107 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 格式化 Agent Task 状态徽标
+ */
+export function formatAgentTaskStateBadge(state) {
+    if (!state)
+        return '⚪ UNKNOWN';
+    const upper = state.toUpperCase();
+    switch (upper) {
+        case 'COMPLETED':
+        case 'SUCCESS':
+            return '🟢 COMPLETED';
+        case 'IN_PROGRESS':
+        case 'RUNNING':
+            return '🟡 RUNNING';
+        case 'FAILED':
+        case 'FAILURE':
+            return '🔴 FAILED';
+        case 'CANCELLED':
+        case 'CANCELED':
+            return '⚪ CANCELLED';
+        default:
+            return `⚪ ${upper}`;
+    }
+}
+/**
+ * 渲染 Agent Tasks 列表表格
+ */
+export function renderAgentTaskList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无智能体任务 (Agent Tasks)。';
+    }
+    const rows = list.map((t) => {
+        const rawId = String(t.id || '-');
+        const shortId = rawId.length > 8 ? `\`${rawId.slice(0, 8)}...\`` : `\`${rawId}\``;
+        const name = sanitizeCell(t.name || '(无描述)', 40);
+        const stateBadge = formatAgentTaskStateBadge(t.state);
+        let prCell = '-';
+        if (t.pullRequestNumber) {
+            const prText = `#${t.pullRequestNumber}`;
+            prCell = t.pullRequestUrl ? `[${prText}](${t.pullRequestUrl})` : prText;
+        }
+        const created = t.createdAt ? t.createdAt.split('T')[0] : '-';
+        return `| ${shortId} | ${name} | ${stateBadge} | ${prCell} | ${created} |`;
+    });
+    return [
+        `**智能体任务列表 (${list.length} 条):**\n`,
+        '| 任务 ID | 描述 | 状态 | 关联 PR | 创建日期 |',
+        '| :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Agent Task 详情卡片
+ */
+export function renderAgentTaskView(task) {
+    if (!task || typeof task !== 'object') {
+        return '无任务详情数据';
+    }
+    const name = task.name || '(未命名任务)';
+    const stateBadge = formatAgentTaskStateBadge(task.state);
+    const repo = task.repository ? `[${task.repository}](https://github.com/${task.repository})` : '-';
+    const user = task.user?.login || task.user || '-';
+    const created = task.createdAt || '-';
+    const completed = task.completedAt || '-';
+    const lines = [
+        `### 🤖 Agent Task: ${name}\n`,
+        `- **任务 ID**: \`${task.id || '-'}\``,
+        `- **状态**: ${stateBadge}`,
+        `- **目标仓库**: ${repo}`,
+        `- **分派用户**: @${user}`,
+        `- **创建时间**: ${created}`,
+        `- **完成时间**: ${completed}`,
+    ];
+    if (task.pullRequestNumber) {
+        const prTitle = task.pullRequestTitle ? ` - ${task.pullRequestTitle}` : '';
+        const prLink = task.pullRequestUrl
+            ? `[#${task.pullRequestNumber}${prTitle}](${task.pullRequestUrl})`
+            : `#${task.pullRequestNumber}${prTitle}`;
+        lines.push(`- **关联 PR**: ${prLink} (${task.pullRequestState || 'OPEN'})`);
+    }
+    if (task.logs || task.log) {
+        lines.push('\n**会话日志记录:**', '```text', String(task.logs || task.log).trim(), '```');
+    }
+    return lines.join('\n');
+}
+/**
+ * Agent Task 领域综合渲染入口
+ */
+export function renderAgentTaskMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output || value.url;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderAgentTaskList(value.items);
+    }
+    if (args?.action === 'view' || value.id) {
+        return renderAgentTaskView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/codespace.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Codespace 状态徽标
+ */
+export declare function formatCodespaceStateBadge(state?: string): string;
+/**
+ * 渲染 Codespaces 列表表格
+ */
+export declare function renderCodespaceList(items: any[]): string;
+/**
+ * 渲染单个 Codespace 详情卡片
+ */
+export declare function renderCodespaceView(cs: any): string;
+/**
+ * Codespace 领域综合渲染入口
+ */
+export declare function renderCodespaceMarkdown(args: any, value: any): string;

package/lib/renderers/codespace.js

@@ -0,0 +1,103 @@
+import { sanitizeCell } from './common.js';
+import { renderScopeRequiredMarkdown } from './project.js';
+/**
+ * 格式化 Codespace 状态徽标
+ */
+export function formatCodespaceStateBadge(state) {
+    if (!state)
+        return '⚪ UNKNOWN';
+    const lower = state.toLowerCase();
+    if (lower === 'available')
+        return '🟢 AVAILABLE';
+    if (lower === 'shutdown')
+        return '⚪ SHUTDOWN';
+    if (lower.includes('start') || lower.includes('rebuild'))
+        return '🟡 STARTING';
+    if (lower.includes('updat') || lower.includes('export'))
+        return '🟡 BUSY';
+    return `⚪ ${state.toUpperCase()}`;
+}
+/**
+ * 渲染 Codespaces 列表表格
+ */
+export function renderCodespaceList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无云端开发环境 (Codespaces)。';
+    }
+    const rows = list.map((cs) => {
+        const name = `\`${sanitizeCell(cs.name || '-', 25)}\``;
+        const displayName = sanitizeCell(cs.displayName || cs.name || '-', 25);
+        const repo = cs.repository ? `[${cs.repository}](https://github.com/${cs.repository})` : '-';
+        const stateBadge = formatCodespaceStateBadge(cs.state);
+        const machine = sanitizeCell(cs.machineDisplayName || cs.machineName || '-', 20);
+        const lastUsed = cs.lastUsedAt ? cs.lastUsedAt.split('T')[0] : '-';
+        return `| ${name} | ${displayName} | ${repo} | ${stateBadge} | ${machine} | ${lastUsed} |`;
+    });
+    return [
+        `**云端开发环境列表 (${list.length} 台):**\n`,
+        '| 实例标识 | 显示名称 | 关联仓库 | 运行状态 | 机器规格 | 上次使用 |',
+        '| :--- | :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Codespace 详情卡片
+ */
+export function renderCodespaceView(cs) {
+    if (!cs || typeof cs !== 'object') {
+        return '无云端环境详情数据';
+    }
+    const name = cs.displayName || cs.name || '未命名实例';
+    const stateBadge = formatCodespaceStateBadge(cs.state);
+    const repo = cs.repository ? `[${cs.repository}](https://github.com/${cs.repository})` : '-';
+    const owner = cs.owner || cs.billableOwner || '-';
+    const machine = cs.machineDisplayName || cs.machineName || '-';
+    const created = cs.createdAt || '-';
+    const lastUsed = cs.lastUsedAt || '-';
+    const lines = [
+        `### ☁️ Codespace: ${name}\n`,
+        `- **实例标识**: \`${cs.name || '-'}\``,
+        `- **运行状态**: ${stateBadge}`,
+        `- **关联仓库**: ${repo}`,
+        `- **所有者**: @${owner}`,
+        `- **机器规格**: ${machine}`,
+        `- **空闲停机**: ${cs.idleTimeoutMinutes ? `${cs.idleTimeoutMinutes} 分钟` : '默认'}`,
+        `- **创建时间**: ${created}`,
+        `- **上次活跃**: ${lastUsed}`,
+    ];
+    if (cs.devcontainerPath) {
+        lines.push(`- **容器配置**: \`${cs.devcontainerPath}\``);
+    }
+    return lines.join('\n');
+}
+/**
+ * Codespace 领域综合渲染入口
+ */
+export function renderCodespaceMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value.status === 'SCOPE_REQUIRED') {
+        return renderScopeRequiredMarkdown(value);
+    }
+    if (value.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${value.warning || '⚠️ 操作确认拦截'}`,
+            `> - **影响评估**: ${value.impact || ''}`,
+            `> - **确认指引**: ${value.requiredAction || '如确认继续，请在参数中附加 `confirm: true` 重新调用。'}`,
+        ].join('\n');
+    }
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderCodespaceList(value.items);
+    }
+    if (args?.action === 'view' || value.name) {
+        return renderCodespaceView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/discussion.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 格式化 Discussion 状态徽标
+ */
+export declare function formatDiscussionStateBadge(state?: string, answered?: boolean, closed?: boolean): string;
+/**
+ * 渲染 Discussion 列表表格
+ */
+export declare function renderDiscussionList(items: any[]): string;
+/**
+ * 渲染单个 Discussion 详情卡片
+ */
+export declare function renderDiscussionView(d: any): string;
+/**
+ * Discussion 领域综合渲染入口
+ */
+export declare function renderDiscussionMarkdown(args: any, value: any): string;

package/lib/renderers/discussion.js

@@ -0,0 +1,101 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 格式化 Discussion 状态徽标
+ */
+export function formatDiscussionStateBadge(state, answered, closed) {
+    if (answered)
+        return '🟢 ANSWERED';
+    const effective = state ? String(state).toUpperCase() : (closed ? 'CLOSED' : 'OPEN');
+    if (effective === 'OPEN')
+        return '🔵 OPEN';
+    if (effective === 'CLOSED')
+        return '🟣 CLOSED';
+    return `⚪ ${effective}`;
+}
+/**
+ * 渲染 Discussion 列表表格
+ */
+export function renderDiscussionList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无讨论主题 (Discussions)。';
+    }
+    const rows = list.map((d) => {
+        const num = d.number ? `#${d.number}` : '-';
+        const link = d.url ? `[${num}](${d.url})` : num;
+        const title = sanitizeCell(d.title || '(无标题)', 45);
+        const category = sanitizeCell(d.category?.name || d.category || 'General', 15);
+        const stateBadge = formatDiscussionStateBadge(d.state, d.answered, d.closed);
+        const author = d.author?.login || d.author || '-';
+        const updated = d.updatedAt ? d.updatedAt.split('T')[0] : (d.createdAt ? d.createdAt.split('T')[0] : '-');
+        return `| ${link} | ${title} | \`${category}\` | ${stateBadge} | @${author} | ${updated} |`;
+    });
+    return [
+        `**讨论主题列表 (${list.length} 条):**\n`,
+        '| 编号 | 标题 | 分类 | 状态 | 作者 | 更新日期 |',
+        '| :--- | :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Discussion 详情卡片
+ */
+export function renderDiscussionView(d) {
+    if (!d || typeof d !== 'object') {
+        return '无讨论详情数据';
+    }
+    const num = d.number ? `#${d.number}` : '';
+    const title = d.title || '(无标题)';
+    const stateBadge = formatDiscussionStateBadge(d.state, d.answered, d.closed);
+    const category = d.category?.name || d.category || 'General';
+    const author = d.author?.login || d.author || '-';
+    const created = d.createdAt || '-';
+    const link = d.url ? `[查看原始讨论](${d.url})` : '';
+    const lines = [
+        `### 💬 Discussion ${num}: ${title}\n`,
+        `- **状态**: ${stateBadge}`,
+        `- **分类**: \`${category}\``,
+        `- **发起人**: @${author}`,
+        `- **创建时间**: ${created}`,
+    ];
+    if (link)
+        lines.push(`- **链接**: ${link}`);
+    if (Array.isArray(d.labels) && d.labels.length > 0) {
+        const labelBadges = d.labels.map((l) => `\`${l.name || l}\``).join(' ');
+        lines.push(`- **标签**: ${labelBadges}`);
+    }
+    if (d.body) {
+        lines.push('\n**正文内容:**', '---', d.body.trim(), '---');
+    }
+    // 渲染关联评论列表
+    if (Array.isArray(d.comments) && d.comments.length > 0) {
+        lines.push(`\n**讨论回复 (${d.comments.length} 条):**`);
+        d.comments.forEach((c, index) => {
+            const cAuthor = c.author?.login || c.author || '匿名';
+            const cTime = c.createdAt ? c.createdAt.replace('T', ' ').slice(0, 19) : '';
+            const cBody = (c.body || '').trim();
+            lines.push(`\n> **#${index + 1} 楼 @${cAuthor}** (${cTime}):\n> ${cBody.replace(/\n/g, '\n> ')}`);
+        });
+    }
+    return lines.join('\n');
+}
+/**
+ * Discussion 领域综合渲染入口
+ */
+export function renderDiscussionMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items) {
+        const extra = value.detail || value.output || value.url;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    if (Array.isArray(value.items) && args?.action === 'list') {
+        return renderDiscussionList(value.items);
+    }
+    if (args?.action === 'view' || value.number) {
+        return renderDiscussionView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/markdown.d.ts

@@ -16,3 +16,7 @@ export * from './ruleset.js';
 export * from './cache.js';
 export * from './gist.js';
 export * from './status.js';
+export * from './agent-task.js';
+export * from './discussion.js';
+export * from './project.js';
+export * from './codespace.js';

package/lib/renderers/markdown.js

@@ -16,3 +16,7 @@ export * from './ruleset.js';
 export * from './cache.js';
 export * from './gist.js';
 export * from './status.js';
+export * from './agent-task.js';
+export * from './discussion.js';
+export * from './project.js';
+export * from './codespace.js';

package/lib/renderers/project.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 渲染 GitHub OAuth Scope 权限缺失自愈引导卡片
+ */
+export declare function renderScopeRequiredMarkdown(value: any): string;
+/**
+ * 渲染 Projects 列表表格
+ */
+export declare function renderProjectList(items: any[]): string;
+/**
+ * 渲染单个 Project 详情卡片
+ */
+export declare function renderProjectView(p: any): string;
+/**
+ * 渲染 Project Items 看板条目列表
+ */
+export declare function renderProjectItemList(items: any[]): string;
+/**
+ * Project 领域综合渲染入口
+ */
+export declare function renderProjectMarkdown(args: any, value: any): string;

package/lib/renderers/project.js

@@ -0,0 +1,128 @@
+import { sanitizeCell } from './common.js';
+/**
+ * 渲染 GitHub OAuth Scope 权限缺失自愈引导卡片
+ */
+export function renderScopeRequiredMarkdown(value) {
+    const scope = value.scope || '相关权限';
+    const command = value.command || `gh auth refresh -s ${scope}`;
+    const toolName = value.tool ? `「${value.tool}」` : '';
+    return [
+        `> ### 🔑 需要补充 GitHub 权限授权 (Token Scope)`,
+        `> - **缺少权限**: \`${scope}\``,
+        `> - **影响工具**: ${toolName || '当前操作'}`,
+        `> - **自愈指引**: 请在宿主终端中执行以下单行命令完成授权：`,
+        `>   \`\`\`bash`,
+        `>   ${command}`,
+        `>   \`\`\``,
+        `> - **说明**: 授权完成后无需重启插件，直接重新调用当前工具即可正常执行。`,
+    ].join('\n');
+}
+/**
+ * 渲染 Projects 列表表格
+ */
+export function renderProjectList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 暂无项目规划看板 (Projects)。';
+    }
+    const rows = list.map((p) => {
+        const num = p.number ? `#${p.number}` : '-';
+        const link = p.url ? `[${num}](${p.url})` : num;
+        const title = sanitizeCell(p.title || '(无标题)', 40);
+        const stateBadge = p.closed ? '🟣 CLOSED' : '🔵 OPEN';
+        const visibility = p.public ? '🌐 Public' : '🔒 Private';
+        const desc = sanitizeCell(p.shortDescription || p.readme || '-', 35);
+        return `| ${link} | ${title} | ${stateBadge} | ${visibility} | ${desc} |`;
+    });
+    return [
+        `**项目看板列表 (${list.length} 个):**\n`,
+        '| 编号 | 项目标题 | 状态 | 可见性 | 描述 |',
+        '| :--- | :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * 渲染单个 Project 详情卡片
+ */
+export function renderProjectView(p) {
+    if (!p || typeof p !== 'object') {
+        return '无项目详情数据';
+    }
+    const num = p.number ? `#${p.number}` : '';
+    const title = p.title || '(无标题)';
+    const stateBadge = p.closed ? '🟣 CLOSED' : '🔵 OPEN';
+    const visibility = p.public ? '🌐 Public' : '🔒 Private';
+    const link = p.url ? `[打开项目网页](${p.url})` : '';
+    const lines = [
+        `### 📋 Project ${num}: ${title}\n`,
+        `- **状态**: ${stateBadge}`,
+        `- **可见性**: ${visibility}`,
+        `- **项目 ID**: \`${p.id || '-'}\``,
+    ];
+    if (link)
+        lines.push(`- **项目链接**: ${link}`);
+    if (p.shortDescription)
+        lines.push(`- **简述**: ${p.shortDescription}`);
+    if (p.readme) {
+        lines.push('\n**项目 README 说明:**', '---', p.readme.trim(), '---');
+    }
+    return lines.join('\n');
+}
+/**
+ * 渲染 Project Items 看板条目列表
+ */
+export function renderProjectItemList(items) {
+    const list = items.filter(Boolean);
+    if (list.length === 0) {
+        return '📭 当前项目看板中暂无任何条目 (Items)。';
+    }
+    const rows = list.map((item) => {
+        const rawId = String(item.id || '-');
+        const shortId = rawId.length > 8 ? `\`${rawId.slice(0, 8)}...\`` : `\`${rawId}\``;
+        const title = sanitizeCell(item.title || item.content?.title || '(无标题条目)', 45);
+        const type = item.type || (item.content?.type ? String(item.content.type) : 'DraftIssue');
+        const status = item.status || '-';
+        return `| ${shortId} | ${title} | \`${type}\` | ${status} |`;
+    });
+    return [
+        `**项目看板条目 (${list.length} 条):**\n`,
+        '| 条目 ID | 标题 / 内容 | 类型 | 状态看板 |',
+        '| :--- | :--- | :--- | :--- |',
+        ...rows,
+    ].join('\n');
+}
+/**
+ * Project 领域综合渲染入口
+ */
+export function renderProjectMarkdown(args, value) {
+    if (!value)
+        return '无返回内容';
+    if (value.status === 'SCOPE_REQUIRED') {
+        return renderScopeRequiredMarkdown(value);
+    }
+    if (value.status === 'AWAITING_CONFIRMATION') {
+        return [
+            `> ### ${value.warning || '⚠️ 操作确认拦截'}`,
+            `> - **影响评估**: ${value.impact || ''}`,
+            `> - **确认指引**: ${value.requiredAction || '如确认继续，请在参数中附加 `confirm: true` 重新调用。'}`,
+        ].join('\n');
+    }
+    if (typeof value.result === 'string')
+        return value.result;
+    if (typeof value.message === 'string' && !value.items && !value.projects) {
+        const extra = value.detail || value.output || value.url;
+        return `**${value.message}**` + (extra ? `\n\`\`\`\n${extra}\n\`\`\`` : '');
+    }
+    // 列表渲染（适配 projects 或 items 数组）
+    const listData = Array.isArray(value.projects) ? value.projects : (Array.isArray(value.items) ? value.items : null);
+    if (listData && args?.action === 'list') {
+        return renderProjectList(listData);
+    }
+    if (listData && args?.action === 'item-list') {
+        return renderProjectItemList(listData);
+    }
+    if (args?.action === 'view' || value.number) {
+        return renderProjectView(value);
+    }
+    return JSON.stringify(value, null, 2);
+}

package/lib/renderers/skill.d.ts

@@ -2,3 +2,33 @@
  * Skill 领域渲染器：负责 Agent Skills 跨仓检索结果、已安装列表与预览说明
  */
 export declare function renderSkillMarkdown(args: any, value: any): string;
+export interface SkillDiagnosticItem {
+    type: 'error' | 'warning' | 'fixed';
+    skillName: string;
+    message: string;
+}
+export interface SkillPublishReport {
+    mode: 'dry-run' | 'fix' | 'publish';
+    success: boolean;
+    directory?: string;
+    items: SkillDiagnosticItem[];
+    repoWarnings: string[];
+    summary: string;
+    tag?: string;
+    rawText?: string;
+}
+/**
+ * 解析 gh skill publish 命令输出的 TSV 诊断行与状态汇总
+ *
+ * 核心设计理由与约束：
+ * 1. gh skill publish 命令无论成功还是失败，均采用制表符 `\t` 分隔的 TSV 纯文本行输出；
+ * 2. 诊断行格式：`error\t<skill>\t<msg>`、`warning\t<skill>\t<msg>`、`fixed\t<skill>\t<msg>` 或 `warning\t\t<repo_rule>`；
+ * 3. 校验失败时 exitCode 为 1，但其 stdout 中携带精准的错误项列表，需提取后结构化呈现，绝不能当作盲目异常吞没；
+ * 4. 若未匹配到有效技能或遇到无技能目录，从 stderr 提取根因提示。
+ */
+export declare function parseSkillPublishOutput(rawStdout: string, rawStderr: string, exitOk: boolean, mode: 'dry-run' | 'fix' | 'publish', directory?: string, tag?: string): SkillPublishReport;
+/**
+ * Skill Publish 结构化 Markdown 渲染器
+ * 将体检报告、自动修复明细与正式发布结果转化为紧凑、清晰的表格与指引
+ */
+export declare function renderSkillPublishMarkdown(report: SkillPublishReport): string;