Browse Source

feat(workflows): 优化 issue 分流和处理工作流
- issue-triage: 简化激活流程,增加 skip-triage 标签支持,完善模板格式检查逻辑
- issue-handle-question: 改进问题分类处理流程,更新评论模板和语气风格指导
- issue-handle-*: 统一添加 roles 配置

Co-authored-by: Copilot <copilot@github.com>

ryland 6 months ago
parent
commit
e93dad1250

+ 12 - 43
.github/workflows/issue-handle-enhancement.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"9a879bc0ba4df6113fe1d0197fec5a167734a1d75942bcbbd210fea68de9c683","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"1e692e567c95f76bc51ba8f68a84d8b186898fc4624a153630c7ba98360c0f06","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
 # gh-aw-manifest: {"version":1,"secrets":["GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN","MINIMAX_API_KEY"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/setup-node","sha":"53b83947a5a98c8d113130e565377fae1a50d02f","version":"v6.3.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -78,8 +78,6 @@ run-name: "Issue Handle Enhancement"
 
 jobs:
   activation:
-    needs: pre_activation
-    if: needs.pre_activation.outputs.activated == 'true'
     runs-on: ubuntu-slim
     permissions:
       actions: read
@@ -103,7 +101,6 @@ jobs:
         with:
           destination: ${{ runner.temp }}/gh-aw/actions
           job-name: ${{ github.job }}
-          trace-id: ${{ needs.pre_activation.outputs.setup-trace-id }}
       - name: Resolve host repo for activation checkout
         id: resolve-host-repo
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -212,14 +209,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_89a68feabf897e52_EOF'
+          cat << 'GH_AW_PROMPT_e09a6b14a7c981ab_EOF'
           <system>
-          GH_AW_PROMPT_89a68feabf897e52_EOF
+          GH_AW_PROMPT_e09a6b14a7c981ab_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md"
-          cat << 'GH_AW_PROMPT_89a68feabf897e52_EOF'
+          cat << 'GH_AW_PROMPT_e09a6b14a7c981ab_EOF'
           <safe-output-tools>
           Tools: add_comment, update_issue, add_labels(max:3), missing_tool, missing_data, noop
           </safe-output-tools>
@@ -251,14 +248,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_89a68feabf897e52_EOF
+          GH_AW_PROMPT_e09a6b14a7c981ab_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_89a68feabf897e52_EOF'
+          cat << 'GH_AW_PROMPT_e09a6b14a7c981ab_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/issue-handle-enhancement.md}}
-          GH_AW_PROMPT_89a68feabf897e52_EOF
+          GH_AW_PROMPT_e09a6b14a7c981ab_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -288,7 +285,6 @@ jobs:
           GH_AW_GITHUB_RUN_ID: ${{ github.run_id }}
           GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }}
           GH_AW_INPUTS_ISSUE_NUMBER: ${{ inputs.issue_number }}
-          GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: ${{ needs.pre_activation.outputs.activated }}
         with:
           script: |
             const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
@@ -309,8 +305,7 @@ jobs:
                 GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY,
                 GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID,
                 GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE,
-                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER,
-                GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: process.env.GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED
+                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER
               }
             });
       - name: Validate prompt placeholders
@@ -440,9 +435,9 @@ jobs:
           mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs"
           mkdir -p /tmp/gh-aw/safeoutputs
           mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs
-          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_e594fef1902b041e_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_950a753b0f411027_EOF'
           {"add_comment":{"max":1,"target":"*"},"add_labels":{"max":3,"target":"*"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{},"update_issue":{"allow_body":true,"max":1,"target":"*"}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_e594fef1902b041e_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_950a753b0f411027_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -698,7 +693,7 @@ jobs:
           export GH_AW_ENGINE="claude"
           export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19'
           
-          cat << GH_AW_MCP_CONFIG_c3dac51dbad2289c_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_732c945cb0133249_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -741,7 +736,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_c3dac51dbad2289c_EOF
+          GH_AW_MCP_CONFIG_732c945cb0133249_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -1293,32 +1288,6 @@ jobs:
             const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs');
             await main();
 
-  pre_activation:
-    runs-on: ubuntu-slim
-    outputs:
-      activated: ${{ steps.check_membership.outputs.is_team_member == 'true' }}
-      matched_command: ''
-      setup-trace-id: ${{ steps.setup.outputs.trace-id }}
-    steps:
-      - name: Setup Scripts
-        id: setup
-        uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3
-        with:
-          destination: ${{ runner.temp }}/gh-aw/actions
-          job-name: ${{ github.job }}
-      - name: Check team membership for workflow
-        id: check_membership
-        uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
-        env:
-          GH_AW_REQUIRED_ROLES: "admin,maintainer,write"
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
-            setupGlobals(core, github, context, exec, io, getOctokit);
-            const { main } = require('${{ runner.temp }}/gh-aw/actions/check_membership.cjs');
-            await main();
-
   safe_outputs:
     needs:
       - activation

+ 1 - 0
.github/workflows/issue-handle-enhancement.md

@@ -10,6 +10,7 @@ on:
       payload:
         type: string
         required: false
+  roles: all
 
 permissions:
   contents: read

+ 12 - 43
.github/workflows/issue-handle-other.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"cb62ff9d8eeee7a63ab5c1ac1cd6e82d09bea53e2909bc2262a9630692554014","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"911fc1686b6e43cfe680f70cbf6b7333bd686078648e0e4c730499bf9d5764f6","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
 # gh-aw-manifest: {"version":1,"secrets":["GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN","MINIMAX_API_KEY"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/setup-node","sha":"53b83947a5a98c8d113130e565377fae1a50d02f","version":"v6.3.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -78,8 +78,6 @@ run-name: "Issue Handle Other"
 
 jobs:
   activation:
-    needs: pre_activation
-    if: needs.pre_activation.outputs.activated == 'true'
     runs-on: ubuntu-slim
     permissions:
       actions: read
@@ -103,7 +101,6 @@ jobs:
         with:
           destination: ${{ runner.temp }}/gh-aw/actions
           job-name: ${{ github.job }}
-          trace-id: ${{ needs.pre_activation.outputs.setup-trace-id }}
       - name: Resolve host repo for activation checkout
         id: resolve-host-repo
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -212,14 +209,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_c7343871ba82a46c_EOF'
+          cat << 'GH_AW_PROMPT_5de0b874dd96dbce_EOF'
           <system>
-          GH_AW_PROMPT_c7343871ba82a46c_EOF
+          GH_AW_PROMPT_5de0b874dd96dbce_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md"
-          cat << 'GH_AW_PROMPT_c7343871ba82a46c_EOF'
+          cat << 'GH_AW_PROMPT_5de0b874dd96dbce_EOF'
           <safe-output-tools>
           Tools: add_comment, update_issue, add_labels(max:3), missing_tool, missing_data, noop
           </safe-output-tools>
@@ -251,14 +248,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_c7343871ba82a46c_EOF
+          GH_AW_PROMPT_5de0b874dd96dbce_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_c7343871ba82a46c_EOF'
+          cat << 'GH_AW_PROMPT_5de0b874dd96dbce_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/issue-handle-other.md}}
-          GH_AW_PROMPT_c7343871ba82a46c_EOF
+          GH_AW_PROMPT_5de0b874dd96dbce_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -288,7 +285,6 @@ jobs:
           GH_AW_GITHUB_RUN_ID: ${{ github.run_id }}
           GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }}
           GH_AW_INPUTS_ISSUE_NUMBER: ${{ inputs.issue_number }}
-          GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: ${{ needs.pre_activation.outputs.activated }}
         with:
           script: |
             const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
@@ -309,8 +305,7 @@ jobs:
                 GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY,
                 GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID,
                 GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE,
-                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER,
-                GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: process.env.GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED
+                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER
               }
             });
       - name: Validate prompt placeholders
@@ -440,9 +435,9 @@ jobs:
           mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs"
           mkdir -p /tmp/gh-aw/safeoutputs
           mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs
-          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_d7078fb1334cc69e_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_0b196508359f39d2_EOF'
           {"add_comment":{"max":1,"target":"*"},"add_labels":{"max":3,"target":"*"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{},"update_issue":{"allow_body":true,"max":1,"target":"*"}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_d7078fb1334cc69e_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_0b196508359f39d2_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -698,7 +693,7 @@ jobs:
           export GH_AW_ENGINE="claude"
           export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19'
           
-          cat << GH_AW_MCP_CONFIG_5d6129c31b8d9334_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_341c1527f9b3fe73_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -741,7 +736,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_5d6129c31b8d9334_EOF
+          GH_AW_MCP_CONFIG_341c1527f9b3fe73_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -1293,32 +1288,6 @@ jobs:
             const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs');
             await main();
 
-  pre_activation:
-    runs-on: ubuntu-slim
-    outputs:
-      activated: ${{ steps.check_membership.outputs.is_team_member == 'true' }}
-      matched_command: ''
-      setup-trace-id: ${{ steps.setup.outputs.trace-id }}
-    steps:
-      - name: Setup Scripts
-        id: setup
-        uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3
-        with:
-          destination: ${{ runner.temp }}/gh-aw/actions
-          job-name: ${{ github.job }}
-      - name: Check team membership for workflow
-        id: check_membership
-        uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
-        env:
-          GH_AW_REQUIRED_ROLES: "admin,maintainer,write"
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
-            setupGlobals(core, github, context, exec, io, getOctokit);
-            const { main } = require('${{ runner.temp }}/gh-aw/actions/check_membership.cjs');
-            await main();
-
   safe_outputs:
     needs:
       - activation

+ 1 - 0
.github/workflows/issue-handle-other.md

@@ -10,6 +10,7 @@ on:
       payload:
         type: string
         required: false
+  roles: all
 
 permissions:
   contents: read

+ 14 - 45
.github/workflows/issue-handle-question.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"d057fde8b07d264af1b44909bb7bc08c45502c3bf525d306aebd5bb1edc0fab4","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"e6011834f07077575ae659c32dcaf4f7e5a9f5b23b2ec6c831de82c3ca8dbc74","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
 # gh-aw-manifest: {"version":1,"secrets":["GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN","MINIMAX_API_KEY"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/setup-node","sha":"53b83947a5a98c8d113130e565377fae1a50d02f","version":"v6.3.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -22,7 +22,7 @@
 #
 # For more information: https://github.github.com/gh-aw/introduction/overview/
 #
-# 处理分类为 question 的 issue,进行问题咨询和解答
+# 处理分类为 question 的 issue,进行问题分析、咨询和解答
 #
 # Resolved workflow manifest:
 #   Imports:
@@ -78,8 +78,6 @@ run-name: "Issue Handle Question"
 
 jobs:
   activation:
-    needs: pre_activation
-    if: needs.pre_activation.outputs.activated == 'true'
     runs-on: ubuntu-slim
     permissions:
       actions: read
@@ -103,7 +101,6 @@ jobs:
         with:
           destination: ${{ runner.temp }}/gh-aw/actions
           job-name: ${{ github.job }}
-          trace-id: ${{ needs.pre_activation.outputs.setup-trace-id }}
       - name: Resolve host repo for activation checkout
         id: resolve-host-repo
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -212,14 +209,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_c17aec4e575baa7b_EOF'
+          cat << 'GH_AW_PROMPT_4aabd02f4722b436_EOF'
           <system>
-          GH_AW_PROMPT_c17aec4e575baa7b_EOF
+          GH_AW_PROMPT_4aabd02f4722b436_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md"
-          cat << 'GH_AW_PROMPT_c17aec4e575baa7b_EOF'
+          cat << 'GH_AW_PROMPT_4aabd02f4722b436_EOF'
           <safe-output-tools>
           Tools: add_comment, update_issue, add_labels(max:3), missing_tool, missing_data, noop
           </safe-output-tools>
@@ -251,14 +248,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_c17aec4e575baa7b_EOF
+          GH_AW_PROMPT_4aabd02f4722b436_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_c17aec4e575baa7b_EOF'
+          cat << 'GH_AW_PROMPT_4aabd02f4722b436_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/issue-handle-question.md}}
-          GH_AW_PROMPT_c17aec4e575baa7b_EOF
+          GH_AW_PROMPT_4aabd02f4722b436_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -288,7 +285,6 @@ jobs:
           GH_AW_GITHUB_RUN_ID: ${{ github.run_id }}
           GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }}
           GH_AW_INPUTS_ISSUE_NUMBER: ${{ inputs.issue_number }}
-          GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: ${{ needs.pre_activation.outputs.activated }}
         with:
           script: |
             const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
@@ -309,8 +305,7 @@ jobs:
                 GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY,
                 GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID,
                 GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE,
-                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER,
-                GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: process.env.GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED
+                GH_AW_INPUTS_ISSUE_NUMBER: process.env.GH_AW_INPUTS_ISSUE_NUMBER
               }
             });
       - name: Validate prompt placeholders
@@ -440,9 +435,9 @@ jobs:
           mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs"
           mkdir -p /tmp/gh-aw/safeoutputs
           mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs
-          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_edda95c1fe82130d_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_b0323f79beccb5ac_EOF'
           {"add_comment":{"max":1,"target":"*"},"add_labels":{"max":3,"target":"*"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{},"update_issue":{"allow_body":true,"max":1,"target":"*"}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_edda95c1fe82130d_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_b0323f79beccb5ac_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -698,7 +693,7 @@ jobs:
           export GH_AW_ENGINE="claude"
           export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19'
           
-          cat << GH_AW_MCP_CONFIG_9d762d9e28554dd2_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_565d75702bf7cf58_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -741,7 +736,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_9d762d9e28554dd2_EOF
+          GH_AW_MCP_CONFIG_565d75702bf7cf58_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -1206,7 +1201,7 @@ jobs:
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
         env:
           WORKFLOW_NAME: "Issue Handle Question"
-          WORKFLOW_DESCRIPTION: "处理分类为 question 的 issue,进行问题咨询和解答"
+          WORKFLOW_DESCRIPTION: "处理分类为 question 的 issue,进行问题分析、咨询和解答"
           HAS_PATCH: ${{ needs.agent.outputs.has_patch }}
         with:
           script: |
@@ -1293,32 +1288,6 @@ jobs:
             const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs');
             await main();
 
-  pre_activation:
-    runs-on: ubuntu-slim
-    outputs:
-      activated: ${{ steps.check_membership.outputs.is_team_member == 'true' }}
-      matched_command: ''
-      setup-trace-id: ${{ steps.setup.outputs.trace-id }}
-    steps:
-      - name: Setup Scripts
-        id: setup
-        uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3
-        with:
-          destination: ${{ runner.temp }}/gh-aw/actions
-          job-name: ${{ github.job }}
-      - name: Check team membership for workflow
-        id: check_membership
-        uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
-        env:
-          GH_AW_REQUIRED_ROLES: "admin,maintainer,write"
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
-            setupGlobals(core, github, context, exec, io, getOctokit);
-            const { main } = require('${{ runner.temp }}/gh-aw/actions/check_membership.cjs');
-            await main();
-
   safe_outputs:
     needs:
       - activation

+ 73 - 84
.github/workflows/issue-handle-question.md

@@ -1,6 +1,6 @@
 ---
 name: "Issue Handle Question"
-description: 处理分类为 question 的 issue,进行问题咨询和解答
+description: 处理分类为 question 的 issue,进行问题分析、咨询和解答
 on:
   workflow_call:
     inputs:
@@ -10,6 +10,7 @@ on:
       payload:
         type: string
         required: false
+  roles: all
 
 permissions:
   contents: read
@@ -48,11 +49,11 @@ timeout-minutes: 15
 
 ## 任务目标
 
-1. 验证 issue 是否符合模板格式,不符合则请求补全信息
-2. 理解用户的问题类型(使用咨询、配置帮助、原理了解等)
+1. 验证 issue 是否符合提问模板格式,不符合则请求补全信息
+2. 理解用户的问题类型(使用咨询、配置帮助、原理理解、最佳实践等)
 3. 基于代码和文档分析问题
-4. 给出清晰的回答或引导
-5. 打上适当的标签(类型标签、状态标签等)
+4. 给出清晰、可执行的回答或引导
+5. 打上适当的标签
 
 ## 运行环境
 
@@ -64,49 +65,48 @@ timeout-minutes: 15
 
 ### 可用工具
 - `get_issue` — 获取 issue 完整内容(标题、正文、评论)
-- `search_issues` — 搜索类似的问题 issue
+- `search_issues` — 搜索类似的提问 issue
 - `list_labels` — 获取仓库可用标签
 - `add_labels` — 添加标签
 - `add_comment` — 添加评论
 
-### 权限
-本 workflow 通过 `workflow_call` 被调用,继承调用者的权限。
-
 ## 步骤流程
 
-### 1. 获取完整上下文信息
-使用 `get_issue` 工具获取 issue 的完整内容,包括:
-- Issue 标题
-- Issue 正文
-- 作者信息
-- 现有标签
-- 评论(如有)
+### 1. 获取完整上下文
+使用 `get_issue` 获取 issue 的标题、正文、作者、现有标签和评论。
 
-### 2. 检查 issue 格式是否符合模板标准
+### 2. 检查是否符合提问模板
 对照 `.github/ISSUE_TEMPLATE/question.yaml` 检查:
 
-**逐项验证清单(必须全部通过才能继续):**
+| 检查项 | 预期 |
+|--------|------|
+| 搜索确认 | 已勾选 |
+| 5 分钟思考 | 已勾选 |
+| 阅读 README | 已勾选 |
+| “我的问题” | 非空 |
+
+格式不符合的判定:
+- 任意必填勾选项未勾选
+- “我的问题”为空
+- 缺少足以理解问题的关键信息
+
+#### 模板不符合时的处理
 
-| 检查项 | 预期 | 结果 |
-|--------|------|------|
-| 搜索确认 | 应勾选 | PASS/FAIL |
-| 5分钟思考 | 应勾选 | PASS/FAIL |
-| 阅读README | 应勾选 | PASS/FAIL |
-| 问题描述 | 不能为空 | PASS/FAIL |
+如果格式不符合,必须:
+1. 使用 `add-comment` 说明缺失信息
+2. 使用 `add-labels` 添加 `info-needed`
+3. **立即结束,不再执行后续步骤**
 
-格式不符的判定(满足任意一条即判定失败):
-- 任意必选项未勾选
-- "我的问题"为空
+评论语气要明确但不要生硬。
 
-**判定后的强制操作:**
+如果从内容上看,这仍然是一个有效的提问类 issue,请在评论中明确说明:
+- 分类没有问题,这仍然是 `question`
+- 当前主要问题是模板使用不正确或信息不完整
+- 应改用 `.github/ISSUE_TEMPLATE/question.yaml` 对应的提问模板补齐信息
 
-| 判定结果 | 操作 | 后续步骤 |
-|----------|------|----------|
-| 格式不符 | 1. 使用 `add-comment` 评论说明缺失的信息 2. 使用 `add_labels` 添加 `info-needed` 标签 | **立即结束,不再执行后续步骤** |
-| 格式符合 | 继续执行第3步 | 继续往下 |
+不要把这类情况描述成“无效 issue”或直接否定用户提问本身。
 
 ### 3. 分析问题类型
-理解用户的问题属于哪一类:
 
 | 问题类型 | 描述 | 标签 |
 |----------|------|------|
@@ -117,37 +117,35 @@ timeout-minutes: 15
 | 其他 | 不属于以上类型 | `其他` |
 
 ### 4. 搜索类似问题
-使用 `search_issues` 搜索相同类型的问题:
-- 搜索条件:带有 `question` 标签的开放 issue
-- 如找到类似问题:添加 `repeat` 标签,并引用相关 issue
+使用 `search_issues` 搜索带有 `question` 标签的开放 issue。
 
-### 5. 分析并回答
-基于代码和文档分析问题:
+如果找到明显重复或高度相似的问题:
+- 添加 `repeat` 标签
+- 在回答中引用相关 issue
 
-**问题分类处理**:
+### 5. 分析并回答
+基于代码和文档给出回答:
 
-1. **使用咨询类**:
-   - 查看相关功能的使用文档
+1. **使用咨询类**
    - 提供清晰的使用步骤
-   - 如需要,提供配置示例
+   - 必要时给出配置示例
 
-2. **配置帮助类**:
-   - 分析用户的配置需求
+2. **配置帮助类**
+   - 分析配置需求
    - 提供正确配置方案
-   - 检查是否有配置冲突
+   - 指出常见冲突点
 
-3. **功能原理类**:
-   - 解释功能的工作机制
-   - 提供相关代码位置
+3. **功能原理类**
+   - 解释工作机制
+   - 给出相关代码位置
    - 说明设计意图
 
-4. **最佳实践类**:
-   - 提供优化建议
-   - 分享使用经验
-   - 推荐最佳配置
+4. **最佳实践类**
+   - 给出优化建议
+   - 推荐合理用法
 
-### 6. 输出回答结果
-使用 `add-comment` 发布回答,模板格式如下:
+### 6. 输出回答
+使用 `add-comment` 发布回答,格式如下:
 
 ```markdown
 ## 问题理解
@@ -166,7 +164,7 @@ timeout-minutes: 15
 - 相关配置示例
 
 ### 后续建议
-[如需要进一步帮助可以怎么做]
+[如果需要进一步帮助可以怎么做]
 
 ---
 **分类**: usage / config / 原理 / 最佳实践 / 其他
@@ -176,27 +174,25 @@ timeout-minutes: 15
 ## 输出
 
 ### 标签
-**注意**:以下两种情况互斥,只会触发其中一种:
 
-**情况 A(格式不符)**:
-- 添加 `info-needed` 标签
-- 触发条件:第 2 步检查发现格式缺失
-- 此情况直接退出,不再执行后续步骤
+**情况 A(模板不符)**
+- 添加 `info-needed`
+- 直接结束,不再继续后续步骤
 
-**情况 B(格式符合)**:
-- 保留 `question` 标签
+**情况 B(模板符合)**
+- 保留 `question`
 - 添加问题类型标签:`usage` / `config` / `原理` / `最佳实践` / `其他`
-- 添加状态标签(如适用):`repeat`(有类似issue)
+- 如有类似 issue,可添加 `repeat`
 
 ### 评论
-包含完整的回答内容(格式见第 6 步)
+- 模板不符时:评论应明确指出“这是 question,但模板不对或信息不全,请按提问模板补齐”
+- 模板符合时:评论应包含完整回答
 
 ## 硬性输出规则
 
-1. **禁止空结束**:在结束本次 workflow 前,必须至少产出一个 safe output。
-2. **强制输出最低要求**:如果无法完整回答,至少使用 `add_comment` 发布一条评论说明情况,并使用 `add_labels` 打上 `info-needed` 标签。
-3. **禁止只做内部分析不交付**:即使无法完全回答,也必须给出当前理解、缺失信息和下一步建议。
-4. **无条件产出**:无论分析结果如何,workflow 结束时必须已有 `add_comment` 或 `noop` 或 `missing_data` 输出。
+1. **禁止空结束**:结束前必须至少产出一个 safe output。
+2. **最低交付要求**:如果无法完整回答,至少发布一条评论说明当前理解、缺失信息和下一步建议,并打上 `info-needed`。
+3. **禁止只做内部分析不交付**:即使无法完全回答,也必须给出当前结论或下一步引导。
 
 ## 行为规则
 
@@ -204,8 +200,8 @@ timeout-minutes: 15
 - 使用 `get_issue` 获取 issue 内容
 - 使用 `search_issues` 搜索类似问题
 - 使用 `add_labels` 添加标签
-- 使用 `add_comment` 发布回答评论
-- 基于代码分析提供解答和帮助
+- 使用 `add_comment` 发布评论
+- 基于代码分析提供回答和帮助
 
 ### 不可以做
 - 直接联系用户(私信、@、邮件等)
@@ -214,18 +210,11 @@ timeout-minutes: 15
 - 修改他人的评论
 - 做出无法兑现的承诺
 - 泄露敏感信息
-- 修改他人代码或仓库内容(只读操作)
+- 修改仓库内容(只读分析)
 - 调用除 handle 工作流外的其他工作流
-- 在没有任何 safe output 的情况下直接结束
-
-### 评论语气风格
-- **专业但友善**:像资深开发者回复同事的问题
-- **客观中立**:基于代码分析,不偏袒用户也不偏袒项目
-- **建设性**:指出问题的同时提供解决方案或方向
-- **使用中文**:评论使用中文,术语可保留英文
-
-**示例语气**:
-- ❌ "这么简单的问题都不知道"
-- ❌ "你自己看文档去"
-- ✅ "根据代码分析,这个问题可以通过...来解决"
-- ✅ "这是一个常见的使用问题,可以尝试..."
+
+### 评论语气
+- 专业但友善
+- 客观中立
+- 建设性
+- 使用中文,术语可保留英文

+ 15 - 45
.github/workflows/issue-triage.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"2c53e2e66c2856464cd597e3b89a510079efe9ac9c6facf9a512e57145bd3927","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"6480ab16e23cfedd92d84774e899406c0d199039dd952058c2e0938b338038cd","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
 # gh-aw-manifest: {"version":1,"secrets":["GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GITHUB_TOKEN","MINIMAX_API_KEY"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"373c709c69115d41ff229c7e5df9f8788daa9553","version":"v9"},{"repo":"actions/setup-node","sha":"53b83947a5a98c8d113130e565377fae1a50d02f","version":"v6.3.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"github/gh-aw-actions/setup","sha":"ba90f2186d7ad780ec640f364005fa24e797b360","version":"v0.68.3"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.20"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.20"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.2.19"},{"image":"ghcr.io/github/github-mcp-server:v0.32.0"},{"image":"node:lts-alpine"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -22,7 +22,7 @@
 #
 # For more information: https://github.github.com/gh-aw/introduction/overview/
 #
-# 对新打开的 issue 进行分类,打标签并委托给类型特定的处理工作流
+# 对新打开的 issue 进行分类、打标签,并路由到对应的处理工作流
 #
 # Resolved workflow manifest:
 #   Imports:
@@ -57,6 +57,7 @@ name: "Issue Triage"
     types:
     - opened
     - reopened
+  # roles: all # Roles processed as role check in pre-activation job
   workflow_dispatch:
     inputs:
       aw_context:
@@ -78,8 +79,6 @@ run-name: "Issue Triage"
 
 jobs:
   activation:
-    needs: pre_activation
-    if: needs.pre_activation.outputs.activated == 'true'
     runs-on: ubuntu-slim
     permissions:
       actions: read
@@ -102,7 +101,6 @@ jobs:
         with:
           destination: ${{ runner.temp }}/gh-aw/actions
           job-name: ${{ github.job }}
-          trace-id: ${{ needs.pre_activation.outputs.setup-trace-id }}
       - name: Generate agentic run info
         id: generate_aw_info
         env:
@@ -192,14 +190,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_b1f6e9384a030294_EOF'
+          cat << 'GH_AW_PROMPT_81d84cd495d462e6_EOF'
           <system>
-          GH_AW_PROMPT_b1f6e9384a030294_EOF
+          GH_AW_PROMPT_81d84cd495d462e6_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/xpia.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/temp_folder_prompt.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/markdown.md"
           cat "${RUNNER_TEMP}/gh-aw/prompts/safe_outputs_prompt.md"
-          cat << 'GH_AW_PROMPT_b1f6e9384a030294_EOF'
+          cat << 'GH_AW_PROMPT_81d84cd495d462e6_EOF'
           <safe-output-tools>
           Tools: add_comment, add_labels(max:2), call_workflow, missing_tool, missing_data, noop
           </safe-output-tools>
@@ -231,14 +229,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_b1f6e9384a030294_EOF
+          GH_AW_PROMPT_81d84cd495d462e6_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_b1f6e9384a030294_EOF'
+          cat << 'GH_AW_PROMPT_81d84cd495d462e6_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/issue-triage.md}}
-          GH_AW_PROMPT_b1f6e9384a030294_EOF
+          GH_AW_PROMPT_81d84cd495d462e6_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -268,7 +266,6 @@ jobs:
           GH_AW_GITHUB_REPOSITORY: ${{ github.repository }}
           GH_AW_GITHUB_RUN_ID: ${{ github.run_id }}
           GH_AW_GITHUB_WORKSPACE: ${{ github.workspace }}
-          GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: ${{ needs.pre_activation.outputs.activated }}
         with:
           script: |
             const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
@@ -289,8 +286,7 @@ jobs:
                 GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER: process.env.GH_AW_GITHUB_EVENT_PULL_REQUEST_NUMBER,
                 GH_AW_GITHUB_REPOSITORY: process.env.GH_AW_GITHUB_REPOSITORY,
                 GH_AW_GITHUB_RUN_ID: process.env.GH_AW_GITHUB_RUN_ID,
-                GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE,
-                GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED: process.env.GH_AW_NEEDS_PRE_ACTIVATION_OUTPUTS_ACTIVATED
+                GH_AW_GITHUB_WORKSPACE: process.env.GH_AW_GITHUB_WORKSPACE
               }
             });
       - name: Validate prompt placeholders
@@ -417,9 +413,9 @@ jobs:
           mkdir -p "${RUNNER_TEMP}/gh-aw/safeoutputs"
           mkdir -p /tmp/gh-aw/safeoutputs
           mkdir -p /tmp/gh-aw/mcp-logs/safeoutputs
-          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_c5b6706c86511a33_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_2d65ea78bfc11ce7_EOF'
           {"add_comment":{"max":1,"target":"triggering"},"add_labels":{"allowed":["bug","enhancement","question","other"],"max":2,"target":"triggering"},"call_workflow":{"max":1,"workflow_files":{"issue-handle-bug":"./.github/workflows/issue-handle-bug.lock.yml","issue-handle-enhancement":"./.github/workflows/issue-handle-enhancement.lock.yml","issue-handle-other":"./.github/workflows/issue-handle-other.lock.yml","issue-handle-question":"./.github/workflows/issue-handle-question.lock.yml"},"workflows":["issue-handle-bug","issue-handle-enhancement","issue-handle-question","issue-handle-other"]},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_c5b6706c86511a33_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_2d65ea78bfc11ce7_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -709,7 +705,7 @@ jobs:
           export GH_AW_ENGINE="claude"
           export MCP_GATEWAY_DOCKER_COMMAND='docker run -i --rm --network host -v /var/run/docker.sock:/var/run/docker.sock -e MCP_GATEWAY_PORT -e MCP_GATEWAY_DOMAIN -e MCP_GATEWAY_API_KEY -e MCP_GATEWAY_PAYLOAD_DIR -e MCP_GATEWAY_PAYLOAD_SIZE_THRESHOLD -e DEBUG -e MCP_GATEWAY_LOG_DIR -e GH_AW_MCP_LOG_DIR -e GH_AW_SAFE_OUTPUTS -e GH_AW_SAFE_OUTPUTS_CONFIG_PATH -e GH_AW_SAFE_OUTPUTS_TOOLS_PATH -e GH_AW_ASSETS_BRANCH -e GH_AW_ASSETS_MAX_SIZE_KB -e GH_AW_ASSETS_ALLOWED_EXTS -e DEFAULT_BRANCH -e GITHUB_MCP_SERVER_TOKEN -e GITHUB_MCP_GUARD_MIN_INTEGRITY -e GITHUB_MCP_GUARD_REPOS -e GITHUB_REPOSITORY -e GITHUB_SERVER_URL -e GITHUB_SHA -e GITHUB_WORKSPACE -e GITHUB_TOKEN -e GITHUB_RUN_ID -e GITHUB_RUN_NUMBER -e GITHUB_RUN_ATTEMPT -e GITHUB_JOB -e GITHUB_ACTION -e GITHUB_EVENT_NAME -e GITHUB_EVENT_PATH -e GITHUB_ACTOR -e GITHUB_ACTOR_ID -e GITHUB_TRIGGERING_ACTOR -e GITHUB_WORKFLOW -e GITHUB_WORKFLOW_REF -e GITHUB_WORKFLOW_SHA -e GITHUB_REF -e GITHUB_REF_NAME -e GITHUB_REF_TYPE -e GITHUB_HEAD_REF -e GITHUB_BASE_REF -e GH_AW_SAFE_OUTPUTS_PORT -e GH_AW_SAFE_OUTPUTS_API_KEY -v /tmp/gh-aw/mcp-payloads:/tmp/gh-aw/mcp-payloads:rw -v /opt:/opt:ro -v /tmp:/tmp:rw -v '"${GITHUB_WORKSPACE}"':'"${GITHUB_WORKSPACE}"':rw ghcr.io/github/gh-aw-mcpg:v0.2.19'
           
-          cat << GH_AW_MCP_CONFIG_af152006c991899c_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_80ac6dbf3fdfbe56_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -752,7 +748,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_af152006c991899c_EOF
+          GH_AW_MCP_CONFIG_80ac6dbf3fdfbe56_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -1289,7 +1285,7 @@ jobs:
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
         env:
           WORKFLOW_NAME: "Issue Triage"
-          WORKFLOW_DESCRIPTION: "对新打开的 issue 进行分类,打标签并委托给类型特定的处理工作流"
+          WORKFLOW_DESCRIPTION: "对新打开的 issue 进行分类、打标签,并路由到对应的处理工作流"
           HAS_PATCH: ${{ needs.agent.outputs.has_patch }}
         with:
           script: |
@@ -1376,32 +1372,6 @@ jobs:
             const { main } = require('${{ runner.temp }}/gh-aw/actions/parse_threat_detection_results.cjs');
             await main();
 
-  pre_activation:
-    runs-on: ubuntu-slim
-    outputs:
-      activated: ${{ steps.check_membership.outputs.is_team_member == 'true' }}
-      matched_command: ''
-      setup-trace-id: ${{ steps.setup.outputs.trace-id }}
-    steps:
-      - name: Setup Scripts
-        id: setup
-        uses: github/gh-aw-actions/setup@ba90f2186d7ad780ec640f364005fa24e797b360 # v0.68.3
-        with:
-          destination: ${{ runner.temp }}/gh-aw/actions
-          job-name: ${{ github.job }}
-      - name: Check team membership for workflow
-        id: check_membership
-        uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
-        env:
-          GH_AW_REQUIRED_ROLES: "admin,maintainer,write"
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |
-            const { setupGlobals } = require('${{ runner.temp }}/gh-aw/actions/setup_globals.cjs');
-            setupGlobals(core, github, context, exec, io, getOctokit);
-            const { main } = require('${{ runner.temp }}/gh-aw/actions/check_membership.cjs');
-            await main();
-
   safe_outputs:
     needs:
       - activation

+ 66 - 28
.github/workflows/issue-triage.md

@@ -1,6 +1,6 @@
 ---
 name: "Issue Triage"
-description: 对新打开的 issue 进行分类,打标签并委托给类型特定的处理工作流
+description: 对新打开的 issue 进行分类、打标签,并路由到对应的处理工作流
 on:
   issues:
     types: [opened, reopened]
@@ -10,6 +10,7 @@ on:
         description: "要分类的 issue 编号"
         required: true
         type: string
+  roles: all
 
 permissions:
   contents: read
@@ -61,13 +62,10 @@ timeout-minutes: 5
 ### 可用工具
 使用 `get_issue` GitHub MCP 工具获取 issue 的完整内容。
 
-### 权限限制
-待补充
-
 ## 输出
 
 ### 标签
-- `bug` / `enhancement` / `question` / `other` 四选一
+- 常规分类:`bug` / `enhancement` / `question` / `other`
 
 ### 调用
 触发对应的 handle 工作流,传递 `issue_number` 参数:
@@ -81,47 +79,87 @@ timeout-minutes: 5
 
 ### 硬性输出规则
 
-1. **禁止空结束**:在结束本次 workflow 前,你必须同时产出 `update_issue`(打标签)和 `call-workflow`(调用工作流)。
-2. **必须同时打标签和调用工作流**:分类结果必须同时包含 `update_issue` 打标签 + `call-workflow` 调用对应工作流,缺一不可。
-3. **禁止纯 noop 结束**:不能只输出 `noop` 作为唯一输出。
-4. **禁止只做内部分析不交付**:必须给用户留下可读结果。
-
+1. **默认必须路由**:除“跳过分流”外,结束前必须同时输出 `add-labels` 和 `call-workflow`。
+2. **跳过分流例外**:如果 issue 已带有 `skip-triage` 或 `status-report` 标签,只输出 `noop`,并立即结束。
+3. **禁止只做内部分析不交付**:无论是否路由,都必须留下可读结果。
 
 ## 操作步骤
 
 ### 1. 获取 issue 内容
-使用 `get_issue` 工具获取 issue 的完整内容。
+使用 `get_issue` 工具获取 issue 的完整内容,包括标题、正文、现有标签和评论。
+
+### 2. 检查是否应跳过分流
+优先检查现有标签。
+
+如果 issue 已带有 `skip-triage`标签:
+- 视为日报、周报、状态同步或其他无需进入 handle 流程的元信息 issue
+- 输出 `noop`,说明“检测到跳过分流标签,本次不进入后续处理流程”
+- **立即结束**
+
+### 3. 进行分类
+根据 issue 标题和正文判断类型。
+
+#### 分类标准
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| `bug` | 功能不工作、报错、崩溃、行为异常 | “点击按钮没有反应”、“应用崩溃了” |
+| `enhancement` | 新功能需求、功能改进、交互优化 | “希望支持深色模式”、“建议添加批量操作” |
+| `question` | 使用问题、配置帮助、原理咨询、最佳实践 | “如何使用定时任务?”、“配置项什么意思?” |
+| `other` | 不属于以上类别 | 元讨论、流程问题、基础设施问题 |
+
+### 4. 打标签
+对正常路由的 issue,使用 `add-labels` 添加唯一分类标签。
 
-### 2. 分类
-根据 issue 正文和标题判断类型。
+### 5. 判断issue格式是否符合模板要求
 
-### 3. 打标签
-使用 `update_issue` 工具应用类型标签。
+对应的issue模板文件在'.github/ISSUE_TEMPLATE'目录下,
+- bug模板为'bug_report.yaml'
+- enhancement模板为'feature_request.yaml'
+- question模板为'question.yaml'
+- other模板为'other.yaml'
 
-### 4. 调用 handle 工作流
-使用 `call-workflow` 调用对应工作流。
+如果 issue 标题或正文不符合对应分类的模板要求,则必须使用 `add-comment` 发表评论,然后立即结束,不再调用handle工作流。
+评论必须按下面顺序组织,确保用户容易理解:
+1. 先明确告诉用户:AI 已将当前 issue 分类为哪一类,例如 `question`
+2. 再明确告诉用户:当前 issue 使用的是什么模板,或说明“当前内容看起来并未使用正确模板”
+3. 然后告诉用户:该问题应改用哪个模板,例如 `.github/ISSUE_TEMPLATE/question.yaml`
+4. 最后列出需要补充的最少信息
 
 
+评论示例结构:
+
+```markdown
+你好,感谢你的反馈。
+
+AI 已将当前 issue 分类为:`question`。
+
+目前这条 issue 使用的不是 `question` 模板(或:当前内容看起来没有按 `question` 模板填写)。
+对于这类问题,请改用:`.github/ISSUE_TEMPLATE/question.yaml`
+
+请至少补充以下信息:
+1. 是否已搜索现有 issues 和文档
+2. 是否已阅读 README 和使用说明
+3. 你的具体问题描述
+4. 必要的背景信息、配置、环境或截图
+```
+
+
+### 6. 调用 handle 工作流
+对正常路由的 issue,使用 `call-workflow` 调用对应工作流。
 
 ## 行为规则
 
 ### 可以做
 - 使用 `get_issue` 获取 issue 内容
-- 使用 `update_issue` 打标签
+- 使用 `add-labels` 打标签
 - 使用 `call-workflow` 调用 handle 工作流
-- 使用 `add-comment` 发评论
+- 使用 `add-comment` 发表评论
+- 在命中跳过分流标签时输出 `noop`
 
 ### 不可以做
 - 直接联系用户(私信、@ 等)
 - 关闭 issue
 - 修改 issue 标题、正文等内容
+- 在命中“跳过分流”后继续调用 handle 工作流
 - 调用除 handle 工作流外的其他工作流
-
-## 分类
-
-| 类型 | 说明 | 示例 |
-|------|------|------|
-| `bug` | 功能不工作、错误、崩溃 | "点击按钮没有反应"、"应用崩溃了" |
-| `enhancement` | 新功能或改进现有行为 | "希望支持深色模式"、"建议添加批量操作" |
-| `question` | 使用问题、寻求帮助 | "如何使用定时任务?"、"配置项什么意思?" |
-| `other` | 不属于以上类别 | 元讨论、流程问题、基础设施问题 |

File diff suppressed because it is too large
+ 721 - 0
.github/workflows/pr-review-intent.lock.yml


+ 221 - 0
.github/workflows/pr-review-intent.md

@@ -0,0 +1,221 @@
+---
+name: "PR Review Intent"
+description: 自动审计 Pull Request 的代码意图、隐含约束、实现对齐情况与发布风险
+on:
+  pull_request:
+    types: [opened, reopened]
+  roles: all
+
+permissions:
+  contents: read
+  issues: read
+  pull-requests: read
+  checks: read
+  statuses: read
+
+tools:
+  github:
+    toolsets: [default]
+    min-integrity: none
+    lockdown: false
+
+imports:
+  - shared/engine.md
+  - shared/network.md
+
+safe-outputs:
+  add-comment:
+    max: 1
+    target: triggering
+
+timeout-minutes: 10
+---
+
+# PR Intent/Constraint Reviewer
+
+你是 OnmyojiAutoScript 项目的 Pull Request 意图/约束审计员。
+
+你的职责不是做通用代码风格 review,而是:
+
+- 从代码变更本身重建作者意图
+- 提取实现隐含约束
+- 判断实现是否与意图对齐
+- 输出维护者视角的发布风险与验证缺口
+
+## Mission
+
+你需要回答以下问题:
+
+1. 这次改动最可能想改变什么系统行为
+2. 这次改动隐含依赖了哪些约束、前提或边界条件
+3. 实现是否与推断出来的 intent 基本一致
+4. 是否引入了额外行为变化、只部分覆盖了 intent,或留下关键约束未验证
+5. 维护者最应该关注哪些发布风险和验证缺口
+
+你的交付目标不是“找尽可能多的问题”,而是帮助维护者快速理解:
+
+- 这份 PR 想做什么
+- 它实际做了什么
+- 它依赖什么前提
+- 哪里还不稳或缺验证
+
+## Runtime Context
+
+- **仓库**: ${{ github.repository }}
+- **PR 编号**: ${{ github.event.pull_request.number }}
+- **PR 标题**: ${{ github.event.pull_request.title }}
+- **PR 作者**: @${{ github.actor }}
+- **当前 head SHA**: `${{ github.event.pull_request.head.sha }}`
+- **base SHA**: `${{ github.event.pull_request.base.sha }}`
+
+## Evidence Priority
+
+按以下优先级理解 PR:
+
+1. PR diff
+2. 改动文件列表
+3. 与改动文件相关的源码上下文
+4. PR 标题、描述、commit message
+5. PR 当前评论、review、status
+
+证据规则:
+
+- 代码是 intent reconstruction 的主要证据
+- PR 文本只作为弱参考或交叉验证材料
+- 不要把 PR 描述直接当成事实,必须用代码行为验证
+- 如果代码与 PR 文本冲突,以代码行为为准,并指出叙述偏差
+
+## Decision Heuristics
+
+### 仓库特定高信号区域
+
+遇到以下模式时优先审计:
+
+- `tasks/*/script_task.py` 中的任务流程变化
+- `tasks/GameUi/*` 中的页面识别、页面导航、入口/出口链路变化
+- `assets.py`、JSON 资源元数据、PNG 资源之间的一致性
+- `while True`、等待点击、回退、超时、失败处理路径
+- 是否改变现有入口、出口、前置条件或依赖链
+
+### 提高风险敏感度的情形
+
+- 改动涉及控制流、导航、资源联动、等待/超时
+- PR 修改多个彼此耦合的任务或 UI 文件
+- 代码显式改变流程,但没有看到对应验证说明
+- 改动了识别规则、坐标、资源文件,但没有看到链路层说明
+
+### 你应优先得出的结论类型
+
+Intent/Constraint 审计应尽量收敛到以下结论之一:
+
+- 实现与推断 intent 基本一致
+- 实现只部分覆盖了推断 intent
+- 实现引入了额外行为变化
+- 存在关键约束未验证
+
+## Output Contract
+
+### 去重规则
+
+在输出评论之前,必须先读取当前 PR 已有评论,检查是否已经存在由机器人发布且带有以下标记的评论:
+
+`<!-- pr-intent-review:sha=${{ github.event.pull_request.head.sha }} -->`
+
+如果已存在同一 `head SHA` 的标记评论:
+
+- 输出 `noop`
+- 说明已经审计过当前 commit,避免重复评论
+- 立即结束
+
+### 评论产出规则
+
+每次运行最多发布 **一条** 评论。
+
+评论必须包含唯一标记,格式如下:
+
+`<!-- pr-intent-review:sha=${{ github.event.pull_request.head.sha }} -->`
+
+默认评论结构:
+
+1. `Change Summary`
+2. `Intent Alignment`
+3. `Release Risk`
+4. `Validation Gaps`
+
+按需展开:
+
+5. `Reconstructed Intent`
+6. `Observed Constraints`
+
+结构展开规则:
+
+- 低风险且 intent 明显的 PR,可以省略 `Reconstructed Intent` / `Observed Constraints`
+- 如果改动涉及行为变化、任务流程、资源依赖、页面链路、等待/超时,必须展开这两节
+- 不要为了凑结构而输出空洞内容
+
+### 评论风格规则
+
+- 使用中文输出
+- 语气专业、简洁、维护者视角
+- 结论优先,少说风格建议
+- 不生成 Mermaid 图
+- 不写大段架构废话
+- 对 PNG / 资源类改动不做低价值长篇总结;只有与逻辑、元数据、行为约束相关时才展开
+
+### 不确定性规则
+
+当 intent 不完全清晰时:
+
+- 可以给出“最可能 intent”的保守推断
+- 必须使用体现推断性质的措辞,例如“看起来是在…”、“更像是在尝试…”、“这次改动最可能是为了…”
+- 不能把猜测写成已确认事实
+
+如果由于权限或上下文不足无法形成强结论:
+
+- 仍然要给出简短评论
+- 明确写出信息不足点
+- 不能伪装确定性
+
+### 评论模板
+
+按以下模板输出,允许在低风险场景下省略按需段落,但不得改写标题名称:
+
+```markdown
+<!-- pr-intent-review:sha=${{ github.event.pull_request.head.sha }} -->
+## Change Summary
+- [用 2-4 条短句概括这次改动实际改变了什么行为或结构]
+
+## Reconstructed Intent
+- [仅在需要时输出:从代码推断出的最可能 intent]
+
+## Observed Constraints
+- [仅在需要时输出:这次实现依赖的关键约束、前提或边界]
+
+## Intent Alignment
+- [明确说明:基本一致 / 只部分覆盖 / 引入额外行为变化 / 仍有关键不确定性]
+
+## Release Risk
+- 风险等级:低 / 中 / 高
+- [指出维护者应重点关注的 1-3 个风险点,聚焦影响范围与行为风险]
+
+## Validation Gaps
+- [列出最重要的验证缺口;如果验证已经足够,也要明确写“未看到明显额外验证缺口”]
+```
+
+## Procedure
+
+1. 获取 PR 元数据、文件列表、diff、已有评论、review 和状态
+2. 检查是否已有当前 `head SHA` 的标记评论;如果有则 `noop`
+3. 基于 diff 与源码上下文识别主要行为变化
+4. 从代码重建最可能 intent
+5. 提取关键 constraints
+6. 判断 intent 与实现是否对齐
+7. 评估发布风险与验证缺口
+8. 使用 `add-comment` 发布评论
+
+## Guardrails
+
+1. 结束前必须有 `add-comment` 或 `noop`
+2. 不允许只做内部分析而不交付结果
+3. 不允许输出通用风格建议,除非它直接影响 intent、constraint 或风险判断
+4. 不执行 PR 代码,不依赖 PR 分支里的脚本来形成结论

Some files were not shown because too many files changed in this diff