Add CI artifact link to PR summaries

Author: ding-swj

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to AgentScope are documented in this file.
 
+## Unreleased
+
+### Added
+
+- **CI artifact link in PR summaries.** summarize now links to the GitHub Actions run when GITHUB_RUN_ID is set.
+
 ## [1.0.0] - 2026-06-07
 
 ### Added

bin/agentscope.js

@@ -876,9 +876,10 @@ function renderRunSummary(run, headingLevel = 2, opts = {}) {
 function generateTraceSummary(trace, opts = {}) {
   const warnings = collectTraceQualityWarnings(trace)
   const warningLines = renderQualityWarnings(warnings)
+  const artifactLines = renderArtifactLink()
 
   if (trace.runs.length === 1) {
-    return [renderRunSummary(trace.runs[0], 2, opts), ...warningLines].join('\n').trimEnd()
+    return [renderRunSummary(trace.runs[0], 2, opts), ...warningLines, ...artifactLines].join('\n').trimEnd()
   }
 
   const lines = [
@@ -900,9 +901,25 @@ function generateTraceSummary(trace, opts = {}) {
   }
 
   lines.push(...warningLines)
+  lines.push(...artifactLines)
   return lines.join('\n').trimEnd()
 }
 
+function renderArtifactLink() {
+  const serverUrl = process.env.GITHUB_SERVER_URL || 'https://github.com'
+  const repo = process.env.GITHUB_REPOSITORY
+  const runId = process.env.GITHUB_RUN_ID
+
+  if (!repo || !runId) return []
+
+  const url = `${serverUrl}/${repo}/actions/runs/${runId}`
+  return [
+    '',
+    `Trace artifact: [GitHub Actions run](${url})`,
+    '',
+  ]
+}
+
 function renderQualityWarnings(warnings) {
   if (warnings.length === 0) return []
 

docs/roadmap.md

@@ -63,7 +63,7 @@ The current PR comment summary is useful, but still basic.
 Expected work:
 
 - [x] Add a compact quality checklist.
-- Link uploaded trace artifacts when available.
+- [x] Link uploaded trace artifacts when available.
 - [x] Show omitted action counts more clearly.
 - [x] Keep comments short enough for repeated PR review.
 

test/agentscope-cli.test.mjs

@@ -332,6 +332,31 @@ test('summarize --dry-run renders trace quality warnings', () => {
   })
 })
 
+test('summarize links to CI run when GITHUB_RUN_ID is set', () => {
+  const output = runCli(['summarize', '--input', authTrace, '--dry-run'], {
+    env: {
+      GITHUB_REPOSITORY: 'ding-swj/AgentScope',
+      GITHUB_RUN_ID: '123456',
+    },
+  })
+
+  assert.match(output, /github\.com\/ding-swj\/AgentScope\/actions\/runs\/123456/)
+  assert.match(output, /Trace artifact/)
+})
+
+test('summarize does not link CI run when GITHUB_RUN_ID is absent', () => {
+  const output = runCli(['summarize', '--input', authTrace, '--dry-run'], {
+    env: {
+      GITHUB_REPOSITORY: '',
+      GITHUB_RUN_ID: '',
+      GITHUB_SERVER_URL: '',
+    },
+  })
+
+  assert.doesNotMatch(output, /actions\/runs/)
+  assert.doesNotMatch(output, /Trace artifact/)
+})
+
 test('summarize --compact reduces verification output size', () => {
   withTempDir((dir) => {
     const fixture = writeTraceFixture(dir, 'compact-verification.trace.json', [