@fitlab-ai/agent-infra 0.6.0 → 0.6.1

package/templates/.agents/skills/review-task/reference/report-template.en.md

@@ -19,6 +19,7 @@ Use this template when writing `review.md` or `review-r{N}.md`.
 - **Review Time**: {timestamp}
 - **Scope**: {file-count and major modules}
 - **Overall Verdict**: {Approved / Changes Requested / Rejected}
+- **Findings (AI-actionable)**: 0 blockers, 0 majors, 0 minors / **env-blocked**: 0
 
 ## Findings
 
@@ -42,6 +43,18 @@ Use this template when writing `review.md` or `review-r{N}.md`.
 **File**: `{file-path}:{line-number}`
 **Suggestion**: {improvement suggestion}
 
+## Environment-Blocked Findings
+
+> Items the AI agent cannot close in the current execution environment; they do not participate in the next refine round. Maintainers carry them in the PR description as a "manual verification required" checklist.
+
+#### 1. {environment-blocked finding title}
+**File**: `{file-path}:{line-number}` (if applicable)
+**Description**: {details}
+**Required Environment**: {e.g. Docker sandbox / macOS host / privileged root / third-party account}
+**Manual Verification Steps**: {steps for the human verifier}
+
+> If this round has no env-blocked findings, keep the section heading and write "None".
+
 ## Highlights
 
 - {what went well}

package/templates/.agents/skills/review-task/reference/report-template.zh-CN.md

@@ -19,6 +19,7 @@
 - **审查时间**：{timestamp}
 - **审查范围**：{file-count and major modules}
 - **总体结论**：{通过 / 需要修改 / 拒绝}
+- **发现（AI 可处理）**：0 阻塞项，0 主要，0 次要 / **env-blocked**：0
 
 ## 问题清单
 
@@ -42,6 +43,18 @@
 **文件**：`{file-path}:{line-number}`
 **建议**：{improvement suggestion}
 
+## 环境性遗留
+
+> AI agent 在本执行环境无法闭环的项；不参与下一轮 refine。维护者在 PR description 中以「待人工验证」清单承接。
+
+#### 1. {环境性项标题}
+**文件**：`{file-path}:{line-number}`（如适用）
+**说明**：{details}
+**所需环境**：{e.g. Docker 沙箱 / macOS host / 特权 root / 第三方账号}
+**待人工执行的验证步骤**：{steps for the human verifier}
+
+> 如本轮无 env-blocked 项，保留段落标题并写「（无）」。
+
 ## 亮点
 
 - {what went well}

package/templates/.agents/skills/review-task/reference/review-criteria.en.md

@@ -21,4 +21,22 @@ Follow the `code-review` step in `.agents/workflows/feature-development.yaml`.
 3. **Actionable**: suggest a concrete fix
 4. **Severity-based**: distinguish blockers, major issues, and minor improvements
 
+## Environment-Blocked Classification
+
+Some findings cannot be closed by the AI agent in the current execution environment, for example:
+
+- missing Docker / sandbox access for end-to-end verification
+- missing a specific OS (macOS-only behavior)
+- missing a third-party account / OAuth access
+- missing privileged operations (root, sudo, special network access)
+
+**Classification decision tree**: "Can the AI agent close this without changing the environment?"
+- yes -> one of blocker / major / minor (based on risk)
+- no -> **env-blocked** (a meta-category, not part of severity ordering)
+
+Where env-blocked findings go:
+- record them in the independent review report section "Environment-Blocked Findings"
+- append them to the end of numeric summaries (for example, `(+ 1 env-blocked)`)
+- do **not** send them into the refine loop; maintainers carry them in the PR description as a "manual verification required" checklist
+
 Also inspect `git diff` so the report reflects the full change context.

package/templates/.agents/skills/review-task/reference/review-criteria.zh-CN.md

@@ -21,4 +21,22 @@
 3. **可执行**：给出明确可落地的修复建议
 4. **按严重程度分类**：明确区分 blocker、major 和 minor
 
+## 环境性遗留分类
+
+某些发现项是 AI agent 在本执行环境**无法闭环**的，例如：
+
+- 缺 Docker / 沙箱而无法跑端到端验证
+- 缺特定 OS（macOS-only 行为）
+- 缺第三方账号 / OAuth
+- 缺特权操作（root、sudo、特殊网络）
+
+**分类决策树**：「AI agent 能否在不改环境的前提下独立闭环这一项？」
+- 是 -> blocker / major / minor 之一（按风险定档）
+- 否 -> **env-blocked**（元类目，不参与严重程度排序）
+
+env-blocked 项的去向：
+- 写入 review 报告独立段落「环境性遗留」
+- 在数字摘要末尾附带显示（如 `(+ 1 env-blocked)`）
+- **不**进入 refine 循环；维护者在 PR description 中以「待人工验证」清单形式承接
+
 同时检查 `git diff`，确保报告反映完整的变更上下文。

package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js

@@ -31,8 +31,8 @@ const DEFAULTS = {
     "tools": [
       "claude-code",
       "codex",
-      "opencode",
-      "gemini-cli"
+      "gemini-cli",
+      "opencode"
     ],
     "dockerfile": null,
     "vm": {
@@ -48,6 +48,7 @@ const DEFAULTS = {
     "managed": [
       ".agents/QUICKSTART.md",
       ".agents/README.md",
+      ".agents/hooks/",
       ".agents/rules/",
       ".agents/scripts/",
       ".agents/skills/",
@@ -55,7 +56,7 @@ const DEFAULTS = {
       ".agents/workflows/",
       ".agents/workspace/README.md",
       ".claude/commands/",
-      ".claude/hooks/",
+      ".codex/hooks.json",
       ".gemini/commands/",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",

package/templates/.agents/templates/task.en.md

@@ -6,6 +6,11 @@ workflow: feature-development  # feature-development | bug-fix | code-review | r
 status: open                   # open | in-progress | review | blocked | completed
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
+agent_infra_version: v0.0.0    # Current agent-infra version; refreshed by workflow commands
+priority:                       # Optional Issue field: Urgent | High | Medium | Low
+effort:                         # Optional Issue field: High | Medium | Low
+start_date:                     # Optional Issue field for Feature: YYYY-MM-DD
+target_date:                    # Optional Issue field for Feature: YYYY-MM-DD
 current_step: analysis         # analysis | design | implementation | review | fix | commit
 assigned_to:                   # claude | codex | gemini | opencode | human
 ---

package/templates/.agents/templates/task.zh-CN.md

@@ -6,6 +6,11 @@ workflow: feature-development  # feature-development | bug-fix | code-review | r
 status: open                   # open | in-progress | review | blocked | completed
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
+agent_infra_version: v0.0.0    # 当前 agent-infra 版本；由工作流命令刷新
+priority:                       # 可选 Issue 字段：Urgent | High | Medium | Low
+effort:                         # 可选 Issue 字段：High | Medium | Low
+start_date:                     # Feature 可选 Issue 字段：YYYY-MM-DD
+target_date:                    # Feature 可选 Issue 字段：YYYY-MM-DD
 current_step: analysis         # analysis | design | implementation | review | fix | commit
 assigned_to:                   # claude | codex | gemini | opencode | human
 ---

package/templates/.claude/settings.json

@@ -24,7 +24,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "sh .claude/hooks/check-version-format.sh",
+            "command": "sh \"$(git rev-parse --show-toplevel)/.agents/hooks/check-version-format.sh\"",
             "timeout": 5
           }
         ]

package/templates/.codex/hooks.json

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "^Bash$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh \"$(git rev-parse --show-toplevel)/.agents/hooks/check-version-format.sh\"",
+            "timeout": 5,
+            "statusMessage": "Checking template version before git commit"
+          }
+        ]
+      }
+    ]
+  }
+}