@fitlab-ai/agent-infra 0.5.6 → 0.5.8

package/templates/.agents/scripts/platform-adapters/find-existing-task.github.js

@@ -0,0 +1,272 @@
+import { spawnSync } from "node:child_process";
+import { pathToFileURL } from "node:url";
+
+const markerPattern = /^<!-- sync-issue:(TASK-\d{8}-\d{6}):([a-z][a-z0-9-]*) -->$/;
+
+function parseArgs(argv) {
+  const args = {
+    format: "json"
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--issue") {
+      args.issue = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === "--repo") {
+      args.repo = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === "--format") {
+      args.format = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (arg === "-h" || arg === "--help") {
+      args.help = true;
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return args;
+}
+
+function usage() {
+  return [
+    "Usage:",
+    "  node .agents/scripts/platform-adapters/find-existing-task.js --issue <number> [--repo <owner/name>] [--format json]"
+  ].join("\n");
+}
+
+function runGh(args) {
+  const ghBin = process.env.IMPORT_ISSUE_GH_BIN || "gh";
+  const result = spawnSync(ghBin, args, {
+    encoding: "utf8",
+    maxBuffer: 10 * 1024 * 1024
+  });
+
+  if (result.error) {
+    const error = new Error(`gh command failed: ${result.error.message}`);
+    error.stderr = result.error.message;
+    throw error;
+  }
+
+  if (result.status !== 0) {
+    const stderr = result.stderr.trim() || `gh exited with status ${result.status}`;
+    const error = new Error(stderr);
+    error.stderr = stderr;
+    throw error;
+  }
+
+  return result.stdout;
+}
+
+function resolveRepo(explicitRepo) {
+  if (explicitRepo) {
+    return explicitRepo;
+  }
+
+  const currentRepo = runGh(["repo", "view", "--json", "nameWithOwner", "-q", ".nameWithOwner"]).trim();
+  if (!currentRepo) {
+    throw new Error("Cannot detect current GitHub repository");
+  }
+
+  const upstreamRepo = runGh([
+    "api",
+    `repos/${currentRepo}`,
+    "--jq",
+    "if .fork then .parent.full_name else .full_name end"
+  ]).trim();
+
+  return upstreamRepo || currentRepo;
+}
+
+function parseComments(output) {
+  const trimmed = output.trim();
+  if (!trimmed) {
+    return [];
+  }
+
+  try {
+    const parsed = JSON.parse(trimmed);
+    return Array.isArray(parsed) ? parsed : [parsed];
+  } catch {
+    return trimmed
+      .split(/\r?\n/)
+      .filter(Boolean)
+      .map((line) => JSON.parse(line));
+  }
+}
+
+function fetchComments(repo, issueNumber) {
+  const output = runGh([
+    "api",
+    `repos/${repo}/issues/${issueNumber}/comments`,
+    "--paginate",
+    "--jq",
+    ".[] | @json"
+  ]);
+
+  return parseComments(output);
+}
+
+function firstLine(value) {
+  return String(value || "").split(/\r?\n/, 1)[0].trim();
+}
+
+function normalizeScalar(value) {
+  const trimmed = value.trim();
+  if (
+    (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+    (trimmed.startsWith("'") && trimmed.endsWith("'"))
+  ) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+
+function parseFrontmatterBlock(block) {
+  const match = block.match(/^---\r?\n([\s\S]*?)\r?\n---\s*$/);
+  if (!match) {
+    return null;
+  }
+
+  const metadata = {};
+  for (const rawLine of match[1].split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) {
+      continue;
+    }
+
+    const separatorIndex = line.indexOf(":");
+    if (separatorIndex <= 0) {
+      continue;
+    }
+
+    const key = line.slice(0, separatorIndex).trim();
+    const value = line.slice(separatorIndex + 1).trim();
+    metadata[key] = normalizeScalar(value);
+  }
+
+  return Object.keys(metadata).length > 0 ? metadata : null;
+}
+
+function recoverTaskFrontmatter(body) {
+  const detailsStart = body.search(/<details><summary>[^<]*frontmatter[^<]*<\/summary>/i);
+  if (detailsStart < 0) {
+    return null;
+  }
+
+  const detailsBody = body.slice(detailsStart);
+  const yamlMatch = detailsBody.match(/```yaml\s*([\s\S]*?)\s*```/i);
+  if (!yamlMatch) {
+    return null;
+  }
+
+  return parseFrontmatterBlock(yamlMatch[1].trim());
+}
+
+function collectCandidates(comments) {
+  const byTaskId = new Map();
+
+  for (const comment of comments) {
+    const match = firstLine(comment.body).match(markerPattern);
+    if (!match) {
+      continue;
+    }
+
+    const [, taskId, fileStem] = match;
+    const existing = byTaskId.get(taskId) || {
+      task_id: taskId,
+      first_seen_at: comment.created_at || "",
+      has_task_comment: false,
+      task_comment_body: ""
+    };
+
+    if (!existing.first_seen_at || (comment.created_at && comment.created_at < existing.first_seen_at)) {
+      existing.first_seen_at = comment.created_at;
+    }
+
+    if (fileStem === "task") {
+      existing.has_task_comment = true;
+      existing.task_comment_body = comment.body || "";
+    }
+
+    byTaskId.set(taskId, existing);
+  }
+
+  return [...byTaskId.values()].sort((left, right) => {
+    const createdComparison = String(left.first_seen_at || "").localeCompare(String(right.first_seen_at || ""));
+    if (createdComparison !== 0) {
+      return createdComparison;
+    }
+    return left.task_id.localeCompare(right.task_id);
+  });
+}
+
+function buildResult(comments) {
+  const candidates = collectCandidates(comments);
+  if (candidates.length === 0) {
+    return { found: false };
+  }
+
+  const selectedCandidate = candidates[0];
+  const frontmatter = selectedCandidate.has_task_comment
+    ? recoverTaskFrontmatter(selectedCandidate.task_comment_body)
+    : null;
+
+  const result = {
+    found: true,
+    task_id: selectedCandidate.task_id
+  };
+
+  if (frontmatter) {
+    result.frontmatter = frontmatter;
+  }
+
+  return result;
+}
+
+function main() {
+  let args;
+  try {
+    args = parseArgs(process.argv.slice(2));
+  } catch (error) {
+    console.error(error.message);
+    console.error(usage());
+    process.exit(1);
+  }
+
+  if (args.help) {
+    console.log(usage());
+    return;
+  }
+
+  if (!args.issue) {
+    console.error("Missing required argument: --issue");
+    console.error(usage());
+    process.exit(1);
+  }
+
+  if (args.format !== "json") {
+    console.error(`Unsupported format: ${args.format}`);
+    process.exit(1);
+  }
+
+  try {
+    const repo = resolveRepo(args.repo);
+    const comments = fetchComments(repo, args.issue);
+    console.log(JSON.stringify(buildResult(comments), null, 2));
+  } catch (error) {
+    console.error(`Cannot scan issue comments: ${error.stderr || error.message}`);
+    process.exit(2);
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}

package/templates/.agents/scripts/platform-adapters/find-existing-task.js

@@ -0,0 +1,5 @@
+import { pathToFileURL } from "node:url";
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  console.log(JSON.stringify({ found: false }, null, 2));
+}

package/templates/.agents/scripts/platform-adapters/platform-sync.github.js

@@ -9,6 +9,26 @@ const DEFAULT_RETRY_DELAYS_MS = [3000, 10000];
 let activeShared = null;
 let repoRoot = "";
 
+export function getDefaults() {
+  return {
+    statusLabels: {
+      pendingDesignWork: "status: pending-design-work",
+      inProgress: "status: in-progress",
+      blocked: "status: blocked",
+      completed: "status: completed",
+      waitingForTriage: "status: waiting-for-triage"
+    },
+    markers: {
+      task: "<!-- sync-issue:{task-id}:task -->",
+      artifact: "<!-- sync-issue:{task-id}:{artifact-stem} -->",
+      artifactChunk: "<!-- sync-issue:{task-id}:{artifact-stem}:{part}/{total} -->",
+      summary: "<!-- sync-issue:{task-id}:summary -->",
+      cancel: "<!-- sync-issue:{task-id}:cancel -->",
+      prSummary: "<!-- sync-pr:{task-id}:summary -->"
+    }
+  };
+}
+
 function getShared() {
   if (!activeShared) {
     throw new Error("platform-sync adapter shared utilities are unavailable");
@@ -124,12 +144,16 @@ function buildSyncContext({ taskDir, config, artifactFile }) {
     return { earlyReturn: blockedResult(CHECK_TYPE, upstreamRepo.message, "network_error") };
   }
   const permissions = detectPermissions(upstreamRepo.value, taskDir);
+  const expectedValues = resolveExpectedValues(config);
+  if (!expectedValues.ok) {
+    return { earlyReturn: failResult(CHECK_TYPE, expectedValues.message, "check_failed") };
+  }
 
-  const marker = config.expected_comment_marker
-    ? interpolate(config.expected_comment_marker, taskDir, artifactFile)
+  const marker = expectedValues.commentMarker
+    ? interpolate(expectedValues.commentMarker, taskDir, artifactFile)
     : null;
-  const prMarker = config.expected_pr_comment_marker
-    ? interpolate(config.expected_pr_comment_marker, taskDir, artifactFile)
+  const prMarker = expectedValues.prCommentMarker
+    ? interpolate(expectedValues.prCommentMarker, taskDir, artifactFile)
     : null;
   const artifactPath = artifactFile ? path.join(taskDir, artifactFile) : null;
 
@@ -144,11 +168,65 @@ function buildSyncContext({ taskDir, config, artifactFile }) {
     upstreamRepo: upstreamRepo.value,
     hasTriage: permissions.hasTriage,
     hasPush: permissions.hasPush,
+    expectedStatusLabel: expectedValues.statusLabel,
     marker,
     prMarker
   };
 }
 
+function resolveExpectedValues(config) {
+  const defaults = getDefaults();
+  const statusLabel = resolveDefaultValue({
+    collection: defaults.statusLabels,
+    key: config.expected_status_label_key,
+    value: config.expected_status_label,
+    configKey: "expected_status_label_key"
+  });
+  if (!statusLabel.ok) {
+    return statusLabel;
+  }
+
+  const commentMarker = resolveDefaultValue({
+    collection: defaults.markers,
+    key: config.expected_comment_marker_key,
+    value: config.expected_comment_marker,
+    configKey: "expected_comment_marker_key"
+  });
+  if (!commentMarker.ok) {
+    return commentMarker;
+  }
+
+  const prCommentMarker = resolveDefaultValue({
+    collection: defaults.markers,
+    key: config.expected_pr_comment_marker_key,
+    value: config.expected_pr_comment_marker,
+    configKey: "expected_pr_comment_marker_key"
+  });
+  if (!prCommentMarker.ok) {
+    return prCommentMarker;
+  }
+
+  return {
+    ok: true,
+    statusLabel: statusLabel.value,
+    commentMarker: commentMarker.value,
+    prCommentMarker: prCommentMarker.value
+  };
+}
+
+function resolveDefaultValue({ collection, key, value, configKey }) {
+  if (!key) {
+    return { ok: true, value: value || null };
+  }
+
+  const resolvedValue = collection[key];
+  if (!resolvedValue) {
+    return { ok: false, message: `Unknown ${configKey}: ${key}` };
+  }
+
+  return { ok: true, value: resolvedValue };
+}
+
 function fetchRemoteData(context) {
   let issueResult = withRetry(() => ghJson([
     "issue",
@@ -209,7 +287,7 @@ function fetchRemoteData(context) {
   }
 
   let prComments = null;
-  if (context.config.expected_pr_comment_marker) {
+  if (context.prMarker) {
     if (!context.prNumber) {
       return {
         earlyReturn: failResult(CHECK_TYPE, "Expected a valid pr_number for PR comment verification", "check_failed")
@@ -323,7 +401,9 @@ function mapTaskTypeToLabel(taskType) {
 function shouldFetchComments(config) {
   return Boolean(
     config.expected_comment_marker
+    || config.expected_comment_marker_key
     || config.expected_pr_comment_marker
+    || config.expected_pr_comment_marker_key
     || config.verify_pr_comment_last_commit_matches_head
     || config.verify_comment_content
     || config.verify_task_comment_content
@@ -339,7 +419,7 @@ function flattenComments(value) {
 }
 
 function checkStatusLabel(context, remoteData) {
-  if (!context.config.expected_status_label || !context.hasTriage) {
+  if (!context.expectedStatusLabel || !context.hasTriage) {
     return null;
   }
 
@@ -348,12 +428,12 @@ function checkStatusLabel(context, remoteData) {
   }
 
   const labels = extractLabelNames(remoteData.issue.labels);
-  if (labels.includes(context.config.expected_status_label)) {
+  if (labels.includes(context.expectedStatusLabel)) {
     return null;
   }
 
   return failResult(CHECK_TYPE,
-    `Expected label '${context.config.expected_status_label}' not found on Issue #${context.issueNumber}`,
+    `Expected label '${context.expectedStatusLabel}' not found on Issue #${context.issueNumber}`,
     "check_failed"
   );
 }

package/templates/.agents/scripts/platform-adapters/platform-sync.js

@@ -0,0 +1,13 @@
+export function getDefaults() {
+  return {
+    statusLabels: {},
+    markers: {}
+  };
+}
+
+export function check(_context, shared) {
+  return shared.passResult(
+    "platform-sync",
+    "Skipped: this code platform does not provide a built-in platform-sync adapter"
+  );
+}

package/templates/.agents/skills/analyze-task/SKILL.en.md

@@ -41,7 +41,7 @@ Read `task.md` carefully to understand:
 - currently known affected files and constraints
 
 If `task.md` contains these source fields, also read the corresponding source information:
-- `issue_number` - GitHub Issue
+- `issue_number` - Issue
 - `codescan_alert_number` - Code Scanning alert
 - `security_alert_number` - Dependabot alert
 
@@ -70,7 +70,7 @@ Create `.agents/workspace/active/{task-id}/{analysis-artifact}`.
 
 ## Requirement Source
 
-**Source type**: {User description / GitHub Issue / Code Scanning / Dependabot / Other}
+**Source type**: {User description / Issue / Code Scanning / Dependabot / Other}
 **Source summary**:
 > {Task source or key context}
 
@@ -121,7 +121,7 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 If task.md contains a valid `issue_number`, perform these sync actions (skip and continue on any failure):
 - Read `.agents/rules/issue-sync.md` before syncing, and complete upstream repository detection plus permission detection
 - Set `status: pending-design-work` by following issue-sync.md
-- Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Create or update the task comment marker defined in `.agents/rules/issue-sync.md` (follow the task.md comment sync rule in issue-sync.md)
 - Publish the `{analysis-artifact}` comment
 
 ### 7. Verification Gate
@@ -143,7 +143,7 @@ Keep the gate output in your reply as fresh evidence. Do not claim completion wi
 
 > Execute this step only after the verification gate passes.
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 Output format:
 ```
@@ -172,7 +172,7 @@ Next step - create technical plan:
 - [ ] Updated `assigned_to` in task.md
 - [ ] Appended an Activity Log entry to task.md
 - [ ] Marked requirement-analysis as complete in workflow progress
-- [ ] Informed the user of the next step (must include all TUI command formats; do not filter)
+- [ ] Informed the user of the next step (must include all TUI command formats, including any custom TUIs; do not filter)
 - [ ] **Did not modify any business code**
 
 ## STOP

package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md

@@ -41,7 +41,7 @@ description: "分析任务并输出需求分析文档"
 - 当前已知的受影响文件和约束
 
 如 `task.md` 包含以下来源字段，补充读取对应来源信息：
-- `issue_number` - GitHub Issue
+- `issue_number` - Issue
 - `codescan_alert_number` - Code Scanning 告警
 - `security_alert_number` - Dependabot 告警
 
@@ -70,7 +70,7 @@ description: "分析任务并输出需求分析文档"
 
 ## 需求来源
 
-**来源类型**：{用户描述 / GitHub Issue / Code Scanning / Dependabot / 其他}
+**来源类型**：{用户描述 / Issue / Code Scanning / Dependabot / 其他}
 **来源摘要**：
 > {任务来源或关键上下文}
 
@@ -121,7 +121,7 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：
 - 执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测
 - 按 issue-sync.md 设置 `status: pending-design-work`
-- 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 创建或更新 `.agents/rules/issue-sync.md` 中定义的 task 评论标记（按 issue-sync.md 的 task.md 评论同步规则）
 - 发布 `{analysis-artifact}` 评论
 
 ### 7. 完成校验
@@ -143,7 +143,7 @@ node .agents/scripts/validate-artifact.js gate analyze-task .agents/workspace/ac
 
 > 仅在校验通过后执行本步骤。
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 输出格式：
 ```
@@ -172,7 +172,7 @@ node .agents/scripts/validate-artifact.js gate analyze-task .agents/workspace/ac
 - [ ] 更新了 task.md 中的 `assigned_to`
 - [ ] 追加了 Activity Log 条目到 task.md
 - [ ] 在工作流进度中标记了 requirement-analysis 为已完成
-- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，含自定义 TUI，不要筛选）
 - [ ] **没有修改任何业务代码**
 
 ## 停止

package/templates/.agents/skills/analyze-task/config/verify.json

@@ -37,7 +37,9 @@
       "verify_comment_content": true,
       "verify_task_comment_content": true,
       "verify_issue_type": true,
-      "verify_milestone": true
+      "verify_milestone": true,
+      "expected_status_label_key": "pendingDesignWork",
+      "expected_comment_marker_key": "artifact"
     }
   }
 }

package/templates/.agents/skills/block-task/SKILL.en.md

@@ -93,7 +93,7 @@ Keep the gate output in your reply as fresh evidence. Do not claim completion wi
 
 > Execute this step only after the verification gate passes.
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 Output format:
 ```

package/templates/.agents/skills/block-task/SKILL.zh-CN.md

@@ -93,7 +93,7 @@ node .agents/scripts/validate-artifact.js gate block-task .agents/workspace/bloc
 
 > 仅在校验通过后执行本步骤。
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 输出格式：
 ```

package/templates/.agents/skills/block-task/config/verify.json

@@ -22,7 +22,8 @@
     },
     "platform-sync": {
       "when": "issue_number_exists",
-      "expected_status_label": "status: blocked"
+      "expected_status_label": "status: blocked",
+      "expected_status_label_key": "blocked"
     }
   }
 }

package/templates/.agents/skills/cancel-task/SKILL.en.md

@@ -79,8 +79,8 @@ If a valid `issue_number` exists:
 - Remove all `in:` labels by following issue-sync.md
 - Remove the milestone by following issue-sync.md
 - Remove all assignees (skip directly when permission is insufficient; no fallback)
-- Publish a cancellation comment using the marker `<!-- sync-issue:{task-id}:cancel -->`
-- Create or update the `<!-- sync-issue:{task-id}:task -->` comment using the task-comment sync rules from `.agents/rules/issue-sync.md`
+- Publish a cancellation comment using the cancel marker defined in `.agents/rules/issue-sync.md`
+- Create or update the task comment marker defined in `.agents/rules/issue-sync.md` using the task-comment sync rules from `.agents/rules/issue-sync.md`
 - Close the Issue by following the "Close an Issue" command in `.agents/rules/issue-pr-commands.md`, using the fixed reason `not planned`
 
 The cancellation comment must include at least:
@@ -106,7 +106,7 @@ Keep the gate output in your reply as fresh evidence. Do not claim completion wi
 
 > Execute this step only after the verification gate passes.
 
-> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 Output format:
 ```

package/templates/.agents/skills/cancel-task/SKILL.zh-CN.md

@@ -79,8 +79,8 @@ ls .agents/workspace/completed/{task-id}/task.md
 - 按 issue-sync.md 移除所有 `in:` labels
 - 按 issue-sync.md 移除 milestone
 - 移除全部 assignees（无权限时直接跳过，不做替代）
-- 发布取消评论，隐藏标记使用 `<!-- sync-issue:{task-id}:cancel -->`
-- 使用 `.agents/rules/issue-sync.md` 的 task.md 评论同步规则创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论
+- 发布取消评论，隐藏标记使用 `.agents/rules/issue-sync.md` 中定义的 cancel 评论标记
+- 使用 `.agents/rules/issue-sync.md` 的 task.md 评论同步规则创建或更新 `.agents/rules/issue-sync.md` 中定义的 task 评论标记
 - 关闭 Issue：按 `.agents/rules/issue-pr-commands.md` 中的“关闭 Issue”命令执行，关闭原因固定为 `not planned`
 
 取消评论至少包含：
@@ -106,7 +106,7 @@ node .agents/scripts/validate-artifact.js gate cancel-task .agents/workspace/com
 
 > 仅在校验通过后执行本步骤。
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）。
 
 输出格式：
 ```
@@ -128,7 +128,7 @@ node .agents/scripts/validate-artifact.js gate cancel-task .agents/workspace/com
 - [ ] 已将任务目录移动到 `.agents/workspace/completed/`
 - [ ] 已在存在 Issue 时完成 Issue 同步
 - [ ] 已运行 gate 校验并通过
-- [ ] 已向用户展示完整的下一步命令
+- [ ] 已向用户展示完整的下一步命令（含自定义 TUI）
 
 ## 注意事项
 

package/templates/.agents/skills/cancel-task/config/verify.json

@@ -24,7 +24,8 @@
     "platform-sync": {
       "when": "issue_number_exists",
       "expected_comment_marker": "<!-- sync-issue:{task-id}:cancel -->",
-      "verify_task_comment_content": true
+      "verify_task_comment_content": true,
+      "expected_comment_marker_key": "cancel"
     }
   }
 }

package/templates/.agents/skills/check-task/SKILL.en.md

@@ -100,7 +100,7 @@ Next step:
 
 ### 5. Recommend Next Action
 
-Recommend the appropriate next skill based on the current workflow state. You must show command formats for all TUI columns in the table below, not just the current AI agent.
+Recommend the appropriate next skill based on the current workflow state. You must show command formats for all TUI columns in the table below, not just the current AI agent. If `.agents/.airc.json` configures custom TUIs (via `customTUIs`), read each tool's `name` and `invoke`, then add the matching command line in the same format (`${skillName}` becomes the skill name and `${projectName}` becomes the project name).
 
 > **⚠️ CONDITION CHECK — you must choose the single matching row in the table below based on `status`, `current_step`, the latest artifacts, and the latest review result:**
 >

package/templates/.agents/skills/check-task/SKILL.zh-CN.md

@@ -100,7 +100,7 @@ description: "查看任务的当前状态和进度"
 
 ### 5. 建议下一步操作
 
-根据当前工作流状态，建议合适的下一个技能。必须展示下表中所有 TUI 列的命令格式，不要只展示当前 AI 代理对应的列：
+根据当前工作流状态，建议合适的下一个技能。必须展示下表中所有 TUI 列的命令格式，不要只展示当前 AI 代理对应的列。如果 `.agents/.airc.json` 中配置了自定义 TUI（`customTUIs`），读取每个工具的 `name` 和 `invoke`，按同样格式补充对应命令行（`${skillName}` 替换为技能名，`${projectName}` 替换为项目名）：
 
 > **⚠️ 条件判断 — 你必须先根据 `status`、`current_step`、最新产物和最新审查结果，选择下表中唯一匹配的一行：**
 >