@fitlab-ai/agent-infra 0.5.7 → 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

@@ -1,3 +1,10 @@
+export function getDefaults() {
+  return {
+    statusLabels: {},
+    markers: {}
+  };
+}
+
 export function check(_context, shared) {
   return shared.passResult(
     "platform-sync",

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

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. 完成校验

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/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:

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`
 
 取消评论至少包含：

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/close-codescan/SKILL.en.md

@@ -61,7 +61,7 @@ Confirm? (y/N)
 
 Dismiss the alert by following the Code Scanning dismiss command in `.agents/rules/security-alerts.md`, passing the mapped `{api-reason}` and the user's explanation.
 
-**API reason mapping** (per the GitHub Code Scanning API):
+**API reason mapping** (per the Code Scanning API):
 - False Positive -> `false positive`
 - Won't Fix -> `won't fix`
 - Used in Tests -> `used in tests`
@@ -96,7 +96,7 @@ Explanation: {explanation}
 
 View: {html_url}
 
-Note: it can be reopened on GitHub if necessary.
+Note: it can be reopened on the platform if necessary.
 
 Next step - complete and archive the task if a related task exists:
   - Claude Code / OpenCode: /complete-task {task-id}

package/templates/.agents/skills/close-codescan/SKILL.zh-CN.md

@@ -61,7 +61,7 @@ Code Scanning 告警 #{alert-number}
 
 按 `.agents/rules/security-alerts.md` 中的 Code Scanning 告警关闭命令执行关闭操作，并传入映射后的 `{api-reason}` 与用户说明。
 
-**API reason 映射**（按 GitHub Code Scanning API）：
+**API reason 映射**（按 Code Scanning API）：
 - 误报 -> `false positive`
 - 不会修复 -> `won't fix`
 - 测试代码 -> `used in tests`
@@ -96,7 +96,7 @@ Code Scanning 告警 #{alert-number} 已关闭。
 
 查看：{html_url}
 
-注意：如有需要，可在 GitHub 上重新打开。
+注意：如有需要，可在 平台上重新打开。
 
 下一步 - 完成并归档任务（如有关联任务）：
   - Claude Code / OpenCode：/complete-task {task-id}

package/templates/.agents/skills/commit/SKILL.en.md

@@ -64,7 +64,7 @@ Failure handling matches "Update Task Status When Applicable": warn, but do **no
 
 ## 7. Sync PR Summary When Applicable
 
-When `{task-id}` exists and task.md contains a valid `pr_number`, refresh the PR summary comment `<!-- sync-pr:{task-id}:summary -->` on the PR. Otherwise, skip this step.
+When `{task-id}` exists and task.md contains a valid `pr_number`, refresh the PR summary comment marked with the PR summary marker defined in `.agents/rules/pr-sync.md` on the PR. Otherwise, skip this step.
 
 > The full trigger conditions, aggregation rules, PATCH/POST flow, shell-safety constraints, and error handling live in `reference/pr-summary-sync.md` (which in turn points to `.agents/rules/pr-sync.md`). Read `reference/pr-summary-sync.md` before executing this step.
 >

package/templates/.agents/skills/commit/SKILL.zh-CN.md

@@ -64,7 +64,7 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 
 ## 7. 同步 PR 摘要（按需）
 
-当 `{task-id}` 存在且 task.md 包含有效 `pr_number` 时，刷新 PR 上的 `<!-- sync-pr:{task-id}:summary -->` 摘要评论；否则跳过。
+当 `{task-id}` 存在且 task.md 包含有效 `pr_number` 时，刷新 PR 上由 `.agents/rules/pr-sync.md` 中定义的 PR 摘要评论标记对应的摘要评论；否则跳过。
 
 > 完整的触发条件、聚合规则、PATCH/POST 流程、Shell 安全约束和错误处理见 `reference/pr-summary-sync.md`（其内联引用 `.agents/rules/pr-sync.md`）。执行此步骤前先读取 `reference/pr-summary-sync.md`。
 >

package/templates/.agents/skills/commit/config/verify.json

@@ -21,7 +21,8 @@
       "when": "pr_number_exists",
       "expected_pr_comment_marker": "<!-- sync-pr:{task-id}:summary -->",
       "verify_in_labels_computed": true,
-      "verify_pr_comment_last_commit_matches_head": true
+      "verify_pr_comment_last_commit_matches_head": true,
+      "expected_pr_comment_marker_key": "prSummary"
     }
   }
 }

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

@@ -93,7 +93,7 @@ If a valid `issue_number` exists:
 - First scan and backfill unpublished `task.md`, `analysis*.md`, `plan*.md`, `implementation*.md`, `review*.md`, and `refinement*.md` comments using the backfill rules in `.agents/rules/issue-sync.md` (`task.md` uses the idempotent update path)
 - Backfill checked `## Requirements` items to the Issue body by following the requirements-checkbox sync steps in issue-sync.md
 - Do not set any `status:` label — status labels are automatically cleared when the Issue is closed
-- Finally create or update the summary comment marked with `<!-- sync-issue:{task-id}:summary -->`
+- Finally create or update the summary comment marked with the summary marker defined in `.agents/rules/issue-sync.md`
 
 ### 7. Verification Gate
 

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

@@ -93,7 +93,7 @@ ls .agents/workspace/completed/{task-id}/task.md
 - 先按 `.agents/rules/issue-sync.md` 的补发规则扫描并补发未发布的 `task.md`、`analysis*.md`、`plan*.md`、`implementation*.md`、`review*.md`、`refinement*.md` 评论（`task.md` 走幂等更新路径）
 - 按 issue-sync.md 的需求复选框同步步骤，兜底同步 `## 需求` 中已勾选的条目到 Issue body
 - 不要设置 `status:` label — Issue 关闭后 status label 会被自动清除
-- 最后创建或更新 `<!-- sync-issue:{task-id}:summary -->` 标记的 summary 评论
+- 最后创建或更新 `.agents/rules/issue-sync.md` 中定义的 summary 评论标记对应的 summary 评论
 
 ### 7. 完成校验
 

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

@@ -29,7 +29,8 @@
       "verify_task_comment_content": true,
       "sync_checked_requirements": true,
       "verify_issue_type": true,
-      "verify_milestone": true
+      "verify_milestone": true,
+      "expected_comment_marker_key": "summary"
     }
   }
 }