Просмотр исходного кода

fix(workflows): update timeout settings and enhance documentation for PR review and weekly report workflows

ryland 6 месяцев назад
Родитель
Сommit
1649f11c76

+ 13 - 13
.github/workflows/pr-review-checklist.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"f003af4646eb95b41c78638d74d1a78a126b073fdec5fd9f70238f9ca79b6731","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"44f4123359aedf28aaffb43b93001f6795012234cea58b684ce4b0257c668e27","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"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -183,14 +183,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_75c41e5b8526b50f_EOF'
+          cat << 'GH_AW_PROMPT_4dd16eb779439a2f_EOF'
           <system>
-          GH_AW_PROMPT_75c41e5b8526b50f_EOF
+          GH_AW_PROMPT_4dd16eb779439a2f_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_75c41e5b8526b50f_EOF'
+          cat << 'GH_AW_PROMPT_4dd16eb779439a2f_EOF'
           <safe-output-tools>
           Tools: add_comment, missing_tool, missing_data, noop
           </safe-output-tools>
@@ -222,14 +222,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_75c41e5b8526b50f_EOF
+          GH_AW_PROMPT_4dd16eb779439a2f_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_75c41e5b8526b50f_EOF'
+          cat << 'GH_AW_PROMPT_4dd16eb779439a2f_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/pr-review-checklist.md}}
-          GH_AW_PROMPT_75c41e5b8526b50f_EOF
+          GH_AW_PROMPT_4dd16eb779439a2f_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -408,9 +408,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_84f1823bc1095422_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_b8d28e4564ea75fe_EOF'
           {"add_comment":{"max":1,"target":"triggering"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_84f1823bc1095422_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_b8d28e4564ea75fe_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -591,7 +591,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_71bf7e99728c026f_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_0901a59055024e4d_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -634,7 +634,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_71bf7e99728c026f_EOF
+          GH_AW_MCP_CONFIG_0901a59055024e4d_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -713,7 +713,7 @@ jobs:
         # - mcp__github__search_pull_requests
         # - mcp__github__search_repositories
         # - mcp__github__search_users
-        timeout-minutes: 10
+        timeout-minutes: 25
         run: |
           set -o pipefail
           touch /tmp/gh-aw/agent-step-summary.md
@@ -1004,7 +1004,7 @@ jobs:
           GH_AW_STALE_LOCK_FILE_FAILED: ${{ needs.activation.outputs.stale_lock_file_failed }}
           GH_AW_GROUP_REPORTS: "false"
           GH_AW_FAILURE_REPORT_AS_ISSUE: "true"
-          GH_AW_TIMEOUT_MINUTES: "10"
+          GH_AW_TIMEOUT_MINUTES: "25"
         with:
           github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
           script: |

+ 44 - 7
.github/workflows/pr-review-checklist.md

@@ -30,7 +30,7 @@ safe-outputs:
     max: 1
     target: triggering
 
-timeout-minutes: 10
+timeout-minutes: 25
 ---
 
 # PR Checklist Reviewer
@@ -65,6 +65,29 @@ timeout-minutes: 10
 - **Checklist 路径**: `.github/workflows/shared/review-checklist.md`
 - **Checklist 来源**: `${{ github.repository }}` @ `${{ github.event.pull_request.base.sha }}`
 
+## MCP Tool Contract
+
+本任务只允许使用两类工具:
+
+1. `github` MCP:
+   - 只读。
+   - 用于读取 PR 元数据、文件列表、diff、评论、review、status。
+   - 用于读取 `${{ github.repository }}` 在 `${{ github.event.pull_request.base.sha }}` 上的 `.github/workflows/shared/review-checklist.md`。
+   - 不负责最终发布评论。
+2. `safeoutputs` MCP:
+   - 最终交付只允许使用 `mcp__safeoutputs__add_comment`。
+   - 该工具负责把最终 `Findings` 评论发布到当前触发的 PR。
+
+硬性规则:
+
+- 不要把普通 assistant 文本当作最终交付。
+- 普通 assistant 文本只允许作为内部草稿,不允许作为最终结果保留在 turn 末尾。
+- 不要在写出 `## Findings` 后直接结束。
+- 不要尝试使用 GitHub MCP 直接创建或发布评论。
+- 如果已存在当前 `head SHA` 的标记评论,则 `noop` 并结束。
+- 如果不存在当前 `head SHA` 的标记评论,则必须调用 `mcp__safeoutputs__add_comment` 后才能结束。
+- 结束前必须做一次自检:最后一个对外动作必须是 `mcp__safeoutputs__add_comment` 或 `noop`,否则继续执行而不是结束。
+
 ## Evidence Priority
 
 按以下优先级理解 PR:
@@ -112,6 +135,13 @@ timeout-minutes: 10
 - 不输出 Mermaid
 - 不写诗、笑话、类比、花哨总结
 
+### 交付要求
+
+- 上面的 markdown 模板只是评论正文模板,不是最终交付动作本身。
+- 先生成评论正文,再把该正文作为 `mcp__safeoutputs__add_comment` 的参数提交。
+- 如果已经生成了评论正文,但还没有调用 `mcp__safeoutputs__add_comment`,任务仍然算未完成。
+- 不允许以“审查结果如下”“我已完成审查”等普通文本结束 turn。
+
 
 ## Procedure
 
@@ -121,12 +151,19 @@ timeout-minutes: 10
 4. 按 checklist 顺序逐条审查 C1 到 C8
 5. 为每条给出状态、定位、一句依据和一句修改建议
 6. 仅收集状态为 `风险` 或 `不确定` 的条目作为 `Findings`
-7. 使用 safe-outputs 的 `add-comment` 发布评论
+7. 先在内部整理完整评论正文,正文必须符合上面的固定模板
+8. 如第 3 步命中重复评论则 `noop`;否则必须调用 `mcp__safeoutputs__add_comment` 发布评论
+9. 发布前自检:确认当前 turn 尚未结束,且评论正文已经完整包含 `<!-- pr-review-checklist:sha=... -->` 与 `## Findings`
+10. `mcp__safeoutputs__add_comment` 调用成功后才允许结束
 
 ## Guardrails
 
-1. 结束前必须有 `add-comment` 或 `noop`
-2. 不允许只做内部分析而不交付结果
-3. 不允许跳过 checklist 条目
-4. 不允许把多个条目合并成一个结论
-5. 不执行 PR 代码,不依赖 PR 分支脚本形成结论
+1. 结束前必须满足二选一:已存在当前 SHA 标记评论并 `noop`;或成功调用 `mcp__safeoutputs__add_comment`
+2. 只输出普通 assistant 文本不算交付结果
+3. 不允许写出 `Findings` 后直接结束 turn
+4. 不允许跳过 checklist 条目
+5. 不允许把多个条目合并成一个结论
+6. 不执行 PR 代码,不依赖 PR 分支脚本形成结论
+7. 即使没有未通过项,也要通过 `mcp__safeoutputs__add_comment` 发布包含 `- 未发现未通过项` 的评论;只有重复评论场景才允许 `noop`
+8. 如果完成审查后发现自己还没有发出 safe-output 工具调用,必须立即调用;不得以普通文本补充说明代替
+9. `end_turn` 之前若没有 safe-output,视为任务失败而不是任务完成

+ 13 - 13
.github/workflows/pr-review-intent.lock.yml

@@ -1,4 +1,4 @@
-# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"c3aaaf877dca5f1bb5bcd2c0510d66da7cfeab45c4d09c7e4711ea8bbed60793","compiler_version":"v0.68.3","strict":true,"agent_id":"claude","agent_model":"MiniMax-M2.7"}
+# gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"41a8c7c15238134edaed9fe948223dcde4d53f986519ec4e514c8db018ebcbff","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"}]}
 #    ___                   _   _      
 #   / _ \                 | | (_)     
@@ -183,14 +183,14 @@ jobs:
         run: |
           bash "${RUNNER_TEMP}/gh-aw/actions/create_prompt_first.sh"
           {
-          cat << 'GH_AW_PROMPT_cae24b275159e63c_EOF'
+          cat << 'GH_AW_PROMPT_999d1f359ec47256_EOF'
           <system>
-          GH_AW_PROMPT_cae24b275159e63c_EOF
+          GH_AW_PROMPT_999d1f359ec47256_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_cae24b275159e63c_EOF'
+          cat << 'GH_AW_PROMPT_999d1f359ec47256_EOF'
           <safe-output-tools>
           Tools: add_comment, missing_tool, missing_data, noop
           </safe-output-tools>
@@ -222,14 +222,14 @@ jobs:
           {{/if}}
           </github-context>
           
-          GH_AW_PROMPT_cae24b275159e63c_EOF
+          GH_AW_PROMPT_999d1f359ec47256_EOF
           cat "${RUNNER_TEMP}/gh-aw/prompts/github_mcp_tools_with_safeoutputs_prompt.md"
-          cat << 'GH_AW_PROMPT_cae24b275159e63c_EOF'
+          cat << 'GH_AW_PROMPT_999d1f359ec47256_EOF'
           </system>
           {{#runtime-import .github/workflows/shared/engine.md}}
           {{#runtime-import .github/workflows/shared/network.md}}
           {{#runtime-import .github/workflows/pr-review-intent.md}}
-          GH_AW_PROMPT_cae24b275159e63c_EOF
+          GH_AW_PROMPT_999d1f359ec47256_EOF
           } > "$GH_AW_PROMPT"
       - name: Interpolate variables and render templates
         uses: actions/github-script@373c709c69115d41ff229c7e5df9f8788daa9553 # v9
@@ -408,9 +408,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_446a3b2e055b908e_EOF'
+          cat > "${RUNNER_TEMP}/gh-aw/safeoutputs/config.json" << 'GH_AW_SAFE_OUTPUTS_CONFIG_10d4017d4ee7631c_EOF'
           {"add_comment":{"max":1,"target":"triggering"},"create_report_incomplete_issue":{},"missing_data":{},"missing_tool":{},"noop":{"max":1,"report-as-issue":"true"},"report_incomplete":{}}
-          GH_AW_SAFE_OUTPUTS_CONFIG_446a3b2e055b908e_EOF
+          GH_AW_SAFE_OUTPUTS_CONFIG_10d4017d4ee7631c_EOF
       - name: Write Safe Outputs Tools
         env:
           GH_AW_TOOLS_META_JSON: |
@@ -591,7 +591,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_ddcb0b07a80fccb2_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
+          cat << GH_AW_MCP_CONFIG_e8a2b49ba3ba7d89_EOF | bash "${RUNNER_TEMP}/gh-aw/actions/start_mcp_gateway.sh"
           {
             "mcpServers": {
               "github": {
@@ -634,7 +634,7 @@ jobs:
               "payloadDir": "${MCP_GATEWAY_PAYLOAD_DIR}"
             }
           }
-          GH_AW_MCP_CONFIG_ddcb0b07a80fccb2_EOF
+          GH_AW_MCP_CONFIG_e8a2b49ba3ba7d89_EOF
       - name: Download activation artifact
         uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
@@ -713,7 +713,7 @@ jobs:
         # - mcp__github__search_pull_requests
         # - mcp__github__search_repositories
         # - mcp__github__search_users
-        timeout-minutes: 10
+        timeout-minutes: 15
         run: |
           set -o pipefail
           touch /tmp/gh-aw/agent-step-summary.md
@@ -1004,7 +1004,7 @@ jobs:
           GH_AW_STALE_LOCK_FILE_FAILED: ${{ needs.activation.outputs.stale_lock_file_failed }}
           GH_AW_GROUP_REPORTS: "false"
           GH_AW_FAILURE_REPORT_AS_ISSUE: "true"
-          GH_AW_TIMEOUT_MINUTES: "10"
+          GH_AW_TIMEOUT_MINUTES: "15"
         with:
           github-token: ${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
           script: |

+ 1 - 1
.github/workflows/pr-review-intent.md

@@ -30,7 +30,7 @@ safe-outputs:
     max: 1
     target: triggering
 
-timeout-minutes: 10
+timeout-minutes: 15
 ---
 
 # PR Intent/Constraint Reviewer

+ 15 - 5
.github/workflows/weekly-report.md

@@ -38,6 +38,13 @@ timeout-minutes: 20
 
 你是 OnmyojiAutoScript 项目的周报生成助手。你的职责是收集本周仓库的活跃数据,生成一份完整的中文周报,以 Issue 形式发布。
 
+## 工具规则
+
+- `github` 只读,只用来收集周报数据。
+- `safeoutputs` 只写,只用来做最终交付。
+- 生成完周报正文后,调用 `mcp__safeoutputs__*` 发布。 issue
+- 不要调用 `mcp__github__create_issue`,也不要把 GitHub MCP 当成写入工具。
+
 ## 数据收集
 
 使用 GitHub MCP 工具收集以下数据:
@@ -48,6 +55,14 @@ timeout-minutes: 20
 - 贡献者列表及头像URL
 - CI/CD运行状态
 
+### Data quality rules
+
+- 不要只取最近几条数据后直接下结论;必须确保拉取数量足以覆盖整个统计窗口
+- 如果单次列表结果不足以覆盖整个统计窗口,应继续获取更多结果,直到可以完成统计
+- 不要把 PR 当作 Issue 重复计数
+- 不要把草稿说明、评论文本或 bot 输出当作 commit 统计来源
+- 在无法精确确认某项数据时,单独标记该项为“暂不可得”,不要让整份周报失败
+
 ## 最终输出模板
 
 输出的语言为中文,且报告必须完全按照以下格式:
@@ -168,8 +183,3 @@ timeout-minutes: 20
 - **要求**:请你自由发挥,不用模板
 - **可选**:亮点、问题、展望、闲聊
 
-## 硬性输出规则
-
-1. **必须产出报告**:workflow结束时必须通过`create-issue`输出完整报告
-2. **禁止空结束**:不能只输出`noop`
-3. **语言**:所有内容使用中文