Merge pull request #11 from LangMem/feat/ci_3

Aias00 · web-flow · commit b73f2ee3961a · 2025-09-05T17:06:47.000+08:00
feat: add automatic summary comments for workflow results in issues
diff --git a/.github/workflows/auto-comment-for-clarity.yml b/.github/workflows/auto-comment-for-clarity.yml
@@ -31,13 +31,13 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-      
+
       - name: Create clarity prompt
         run: |
           mkdir -p /tmp/claude-prompts
           cat > /tmp/claude-prompts/clarity-prompt.txt << 'EOF'
           你是一个专业的社区助手。请分析以下 GitHub issue/discussion 的内容质量。
-          
+
           任务：
           1. 使用 mcp__github__get_issue 获取内容详情
           2. 分析内容是否包含足够的信息：
@@ -46,23 +46,67 @@ jobs:
              - 是否包含期望行为
              - 是否包含环境信息
           3. 如果信息不足，使用 mcp__github__create_comment 添加友好的评论，要求补充信息
-          
+
           评论模板：
           感谢您提交这个 issue/discussion！为了更好地帮助您，请补充以下信息：
           - [ ] 详细的问题描述
           - [ ] 重现步骤（如适用）
           - [ ] 期望的行为
           - [ ] 实际的行为
           - [ ] 环境信息（版本、操作系统等）
-          
+
           请编辑您的原始 issue/discussion 来添加这些信息。
           EOF
-      
+
       - name: Run Claude Code for Auto Comment
+        id: claude_analysis
         uses: anthropics/claude-code-action@v1
         with:
           prompt: $(cat /tmp/claude-prompts/clarity-prompt.txt)
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           claude_args: |
             --allowedTools mcp__github__get_issue,mcp__github__create_comment
             --system-prompt "你是一个经验丰富的开源项目维护者，擅长识别高质量的 issue 报告"
+
+      - name: Post analysis summary as comment
+        if: always()
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issue_number = context.issue.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Get Claude's analysis result
+            const stepOutputs = ${{ toJson(steps.claude_analysis.outputs) }};
+            const analysisResult = stepOutputs.response || stepOutputs.result || stepOutputs.output || '';
+
+            // Get workflow run URL
+            const runUrl = `https://github.com/${owner}/${repo}/actions/runs/${{ github.run_id }}`;
+
+            let commentBody = `## 🤖 Auto Comment Analysis Summary\n\n`;
+
+            if (analysisResult && analysisResult.trim() !== '') {
+              commentBody += `**Claude Analysis Result:**\n\`\`\`\n${analysisResult}\n\`\`\`\n\n`;
+            } else {
+              commentBody += `**Status:** Analysis completed successfully.\n\n`;
+            }
+
+            commentBody += `**Workflow Run:** [View Details](${runUrl})\n`;
+            commentBody += `**Triggered by:** Issue #${issue_number}\n`;
+            commentBody += `**Time:** ${new Date().toISOString()}\n\n`;
+            commentBody += `---\n*This comment was automatically generated by the Auto Comment for Clarity workflow.*`;
+
+            // Only post if this is an issue event (not discussion)
+            if (context.eventName === 'issues') {
+              await github.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number,
+                body: commentBody
+              });
+              console.log('Posted analysis summary to issue #' + issue_number);
+            } else {
+              console.log('Skipped posting comment - not an issue event');
+            }
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
@@ -30,23 +30,30 @@ jobs:
     permissions:
       contents: read
       pull-requests: read
-      issues: read
+      issues: write
       id-token: write
     steps:
-      - uses: anthropics/claude-code-action@v1
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Assistant
+        id: claude_assistant
+        uses: anthropics/claude-code-action@v1
         with:
           anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
           # Or use OAuth token instead:
           # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          
+
           # Optional: provide a prompt for automation workflows
           # prompt: "Review this PR for security issues"
-          
+
           # Optional: pass advanced arguments to Claude CLI
           # claude_args: |
           #   --max-turns 10
           #   --model claude-4-0-sonnet-20250805
-          
+
           # Optional: add custom trigger phrase (default: @claude)
           # trigger_phrase: "/claude"
           # Optional: add assignee trigger for issues
@@ -58,3 +65,51 @@ jobs:
           #   actions: read
           # Optional: allow bot users to trigger the action
           # allowed_bots: "dependabot[bot],renovate[bot]"
+
+      - name: Post Claude assistant summary
+        if: always() && (github.event_name == 'issues' || github.event_name == 'issue_comment')
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Get issue number from different event types
+            let issue_number;
+            if (context.eventName === 'issues') {
+              issue_number = context.issue.number;
+            } else if (context.eventName === 'issue_comment') {
+              issue_number = context.payload.issue.number;
+            } else {
+              console.log('Event type not supported for issue comments');
+              return;
+            }
+
+            // Get Claude's response
+            const stepOutputs = ${{ toJson(steps.claude_assistant.outputs) }};
+            const claudeResponse = stepOutputs.response || stepOutputs.result || stepOutputs.output || '';
+
+            // Get workflow run URL
+            const runUrl = `https://github.com/${owner}/${repo}/actions/runs/${{ github.run_id }}`;
+
+            let commentBody = `## 🤖 Claude Assistant Summary\n\n`;
+
+            if (claudeResponse && claudeResponse.trim() !== '') {
+              commentBody += `**Claude Response:**\n\`\`\`\n${claudeResponse}\n\`\`\`\n\n`;
+            } else {
+              commentBody += `**Status:** Claude assistant completed processing.\n\n`;
+            }
+
+            commentBody += `**Workflow Run:** [View Details](${runUrl})\n`;
+            commentBody += `**Triggered by:** ${context.eventName}\n`;
+            commentBody += `**Time:** ${new Date().toISOString()}\n\n`;
+            commentBody += `---\n*This comment was automatically generated by the Claude Assistant workflow.*`;
+
+            await github.rest.issues.createComment({
+              owner,
+              repo,
+              issue_number,
+              body: commentBody
+            });
+            console.log('Posted Claude assistant summary to issue #' + issue_number);
diff --git a/.github/workflows/issue-translation.yml b/.github/workflows/issue-translation.yml
@@ -0,0 +1,120 @@
+# Copyright 2024-2026 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Bidirectional Issue Translation and Update
+
+on:
+  issues:
+    types: [opened]
+env:
+  ANTHROPIC_BASE_URL: "https://open.bigmodel.cn/api/anthropic"
+jobs:
+  translate_and_update:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Translate issue body with Claude (auto detect)
+        id: translate
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          prompt: |
+            你是一名专业的双语翻译。请自动检测下面文本的主要语言（只会是中文或英文）：
+            - 如果主要语言是中文，请将其准确、地道地翻译为英文，只返回英文翻译。
+            - 如果主要语言是英文，请将其准确、地道地翻译为中文，只返回中文翻译。
+            - 不要解释，不要输出原文，只返回翻译内容。
+            ---
+            ${{ github.event.issue.body }}
+
+      - name: Update issue body with original and translation
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issue_number = context.issue.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const orig = context.payload.issue.body || '';
+
+            // Get the translation from the previous step
+            // Note: The exact output property may vary, trying common ones
+            const stepOutputs = ${{ toJson(steps.translate.outputs) }};
+            const translated = (stepOutputs.response || stepOutputs.result || stepOutputs.output || '').trim();
+
+            // Only update if we have a translation and it's different from original
+            if (translated && translated !== orig && translated !== 'undefined') {
+              const newBody = `## 原文 / Original\n${orig}\n\n## 翻译 / Translation\n${translated}`;
+              await github.rest.issues.update({
+                owner,
+                repo,
+                issue_number,
+                body: newBody,
+              });
+              console.log('Successfully updated issue with translation');
+            } else {
+              console.log('No valid translation received or translation same as original');
+            }
+
+      - name: Post translation workflow summary
+        if: always()
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issue_number = context.issue.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Get translation result
+            const stepOutputs = ${{ toJson(steps.translate.outputs) }};
+            const translated = (stepOutputs.response || stepOutputs.result || stepOutputs.output || '').trim();
+            const original = context.payload.issue.body || '';
+
+            // Get workflow run URL
+            const runUrl = `https://github.com/${owner}/${repo}/actions/runs/${{ github.run_id }}`;
+
+            let commentBody = `## 🌐 Translation Workflow Summary\n\n`;
+
+            if (translated && translated !== original && translated !== 'undefined') {
+              // Detect language
+              const isChineseOriginal = /[\u4e00-\u9fff]/.test(original);
+              const targetLang = isChineseOriginal ? 'English' : 'Chinese';
+              commentBody += `✅ **Translation completed successfully**\n`;
+              commentBody += `- **Source language:** ${isChineseOriginal ? 'Chinese' : 'English'}\n`;
+              commentBody += `- **Target language:** ${targetLang}\n`;
+              commentBody += `- **Issue body has been updated** with both original and translated content\n\n`;
+            } else {
+              commentBody += `ℹ️ **Translation skipped**\n`;
+              commentBody += `- Reason: Translation same as original or no valid translation received\n\n`;
+            }
+
+            commentBody += `**Workflow Run:** [View Details](${runUrl})\n`;
+            commentBody += `**Time:** ${new Date().toISOString()}\n\n`;
+            commentBody += `---\n*This comment was automatically generated by the Translation workflow.*`;
+
+            await github.rest.issues.createComment({
+              owner,
+              repo,
+              issue_number,
+              body: commentBody
+            });
+            console.log('Posted translation summary to issue #' + issue_number);
diff --git a/WORKFLOW_SUMMARY_FEATURE.md b/WORKFLOW_SUMMARY_FEATURE.md
@@ -0,0 +1,96 @@
+# Workflow Summary Feature
+
+## 概述
+
+我们已经为三个主要的 GitHub Actions 工作流添加了自动发布工作流运行结果摘要到 GitHub issue 评论的功能。
+
+## 修改的工作流
+
+### 1. `auto-comment-for-clarity.yml`
+
+- **功能**: 分析 issue 质量并要求补充信息
+- **新增**: 发布 Claude 分析结果摘要到 issue 评论
+- **触发**: 当 issue 被创建时
+
+### 2. `issue-translation.yml`
+
+- **功能**: 自动检测语言并翻译 issue 内容
+- **新增**: 发布翻译工作流摘要到 issue 评论
+- **触发**: 当 issue 被创建时
+
+### 3. `claude.yml`
+
+- **功能**: Claude 助手响应评论和 issue
+- **新增**: 发布 Claude 助手摘要到 issue 评论
+- **触发**: issue 评论、PR 评论、issue 状态变化等
+
+## 功能特性
+
+### 自动摘要评论包含：
+
+- ✅ 工作流执行状态
+- 📊 主要结果内容
+- 🔗 工作流运行详情链接
+- ⏰ 执行时间戳
+- 🏷️ 触发事件信息
+
+### 条件执行：
+
+- 使用 `if: always()` 确保即使前面步骤失败也会发布摘要
+- 智能检测事件类型，只在相关的 issue 上发布评论
+- 避免在 discussion 或 PR 事件上误发评论
+
+## 示例评论格式
+
+### Translation Workflow Summary
+
+```markdown
+## 🌐 Translation Workflow Summary
+
+✅ **Translation completed successfully**
+
+- **Source language:** Chinese
+- **Target language:** English
+- **Issue body has been updated** with both original and translated content
+
+**Workflow Run:** [View Details](https://github.com/LangMem/mem4j/actions/runs/12345)
+**Time:** 2025-09-05T06:50:00.000Z
+
+---
+
+_This comment was automatically generated by the Translation workflow._
+```
+
+### Auto Comment Analysis Summary
+
+```markdown
+## 🤖 Auto Comment Analysis Summary
+
+**Claude Analysis Result:**
+```
+
+Issue quality analysis completed. Additional information requested from user.
+
+```
+
+**Workflow Run:** [View Details](https://github.com/LangMem/mem4j/actions/runs/12346)
+**Triggered by:** Issue #10
+**Time:** 2025-09-05T06:50:00.000Z
+
+---
+*This comment was automatically generated by the Auto Comment for Clarity workflow.*
+```
+
+## 技术实现
+
+1. **步骤标识**: 为 Claude 步骤添加了 `id` 属性以捕获输出
+2. **输出捕获**: 使用 `${{ toJson(steps.step_id.outputs) }}` 获取执行结果
+3. **条件执行**: 使用 `if: always()` 和事件类型检查
+4. **权限更新**: 确保工作流有 `issues: write` 权限
+
+## 好处
+
+- 🔍 **透明度**: 用户可以直接在 issue 中看到自动化工作流的执行结果
+- 📋 **审计**: 完整的执行历史记录和链接
+- 🚀 **效率**: 减少需要手动检查 Actions 页面的需求
+- 🤝 **用户体验**: 更好的社区交互和反馈
