@fitlab-ai/agent-infra 0.7.5 → 0.7.7

package/templates/.agents/skills/watch-pr/SKILL.zh-CN.md

@@ -1,6 +1,8 @@
 ---
 name: watch-pr
-description: "监控 PR 的 required checks 并在失败时自愈"
+description: >
+  监控 PR 的 required checks 并在失败时自愈。
+  当需要监控 PR 的 required checks 并在失败时自愈时使用。
 ---
 
 # 监控 Pull Request
@@ -21,6 +23,16 @@ description: "监控 PR 的 required checks 并在失败时自愈"
 
 > 如果 `{task-id}` 入参匹配 `^[#]?[0-9]+$`（裸数字或带 `#` 前缀），先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 步骤开始：写入 started 标记
+
+确认前置条件后、本轮第一个产出动作之前，向 task.md `## 活动日志` 追加一条 started 标记（与本轮 done 条目同基名 + ` [started]` 后缀，note 用 `started`）：
+
+```
+- {YYYY-MM-DD HH:mm:ss±HH:MM} — **Watch PR (Round {N}) [started]** by {agent} — started
+```
+
+`ai task log` 会把它与完成时写入的 done 条目配对成一行（进行中 → 已完成）。约定见 `.agents/rules/task-management.md` 的「Activity Log started / done 双标记约定」。
+
 ## 执行步骤
 
 ### 1. 解析入参

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

@@ -60,10 +60,15 @@ pr_status: pending             # PR status: pending (default) | created (PR crea
 | id | stage | round | severity | status | evidence |
 |----|-------|-------|----------|--------|----------|
 
+## Human Rulings
+
+<!-- Humans record rulings for needs-human-decision decisions here and flip matching HD- rows in the Review Disagreement Ledger to human-decided. -->
+
 ## Activity Log
 
 <!-- Append a new entry for each workflow step. Do NOT overwrite previous entries. -->
 <!-- Format: - {YYYY-MM-DD HH:mm:ss±HH:MM} — **{step}** by {agent} — {brief summary} -->
+<!-- Some workflow skills also write a started marker when the step begins (action suffixed with ` [started]`) and a done entry on completion; ai task log pairs them onto one row by base action. Convention: see .agents/rules/task-management.md. -->
 
 ## Completion Checklist
 

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

@@ -60,10 +60,15 @@ pr_status: pending             # PR 状态：pending（默认）| created（已
 | id | stage | round | severity | status | evidence |
 |----|-------|-------|----------|--------|----------|
 
+## 人工裁决
+
+<!-- 人类在此记录对 needs-human-decision 决策的裁定，并把 ## 审查分歧账本 对应 HD- 行翻为 human-decided。 -->
+
 ## 活动日志
 
 <!-- 每个工作流步骤追加一条新记录，不要覆盖之前的记录。 -->
 <!-- 格式：- {YYYY-MM-DD HH:mm:ss±HH:MM} — **{步骤}** by {执行者} — {简要说明} -->
+<!-- 部分工作流 SKILL 在步骤开始时额外写一条 started 标记（action 末尾加 ` [started]`），完成时再写 done；ai task log 会按基名把两者配对成一行。约定见 .agents/rules/task-management.md。 -->
 
 ## 完成检查清单