@fitlab-ai/agent-infra 0.5.5 → 0.5.6

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

@@ -935,22 +935,22 @@ function resolveUpstreamRepo(taskDir) {
     return ownerRepo;
   }
 
-  const upstreamResult = ghText([
+  const repoResult = ghJson([
     "api",
-    `repos/${ownerRepo.value}`,
-    "--jq",
-    "if .fork then .parent.full_name else .full_name end"
+    `repos/${ownerRepo.value}`
   ], taskDir);
 
-  if (!upstreamResult.ok) {
-    return upstreamResult;
+  if (!repoResult.ok) {
+    return repoResult;
   }
 
-  if (isBlank(upstreamResult.value)) {
+  const repo = repoResult.value && typeof repoResult.value === "object" ? repoResult.value : {};
+  const upstreamRepo = repo.fork ? repo.parent?.full_name : repo.full_name;
+  if (isBlank(upstreamRepo)) {
     return { ok: false, message: "Unable to resolve upstream repository" };
   }
 
-  return { ok: true, value: upstreamResult.value };
+  return { ok: true, value: upstreamRepo };
 }
 
 function resolveOwnerRepo(taskDir) {
@@ -1017,11 +1017,12 @@ function ghText(args, cwd) {
 }
 
 function ghCommand(args, cwd) {
-  const result = spawnSync("gh", args, {
+  const command = resolveCommand("gh");
+  const result = spawnSync(command, args, commandOptions(command, {
     cwd,
     encoding: "utf8",
     env: process.env
-  });
+  }));
 
   if (result.status !== 0) {
     const stderr = `${result.stderr || ""}${result.stdout || ""}`.trim();
@@ -1037,11 +1038,12 @@ function ghPaginatedJson(args, cwd) {
 }
 
 function gitText(args, cwd) {
-  const result = spawnSync("git", args, {
+  const command = resolveCommand("git");
+  const result = spawnSync(command, args, commandOptions(command, {
     cwd,
     encoding: "utf8",
     env: process.env
-  });
+  }));
 
   if (result.status !== 0) {
     const stderr = `${result.stderr || ""}${result.stdout || ""}`.trim();
@@ -1110,6 +1112,39 @@ function sleep(delayMs) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, delayMs);
 }
 
+function resolveCommand(cmd) {
+  if (process.platform !== "win32" || path.extname(cmd)) {
+    return cmd;
+  }
+
+  const pathValue = process.env.Path || process.env.PATH || "";
+  const extensions = (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD")
+    .split(";")
+    .filter(Boolean);
+
+  for (const dir of pathValue.split(path.delimiter).filter(Boolean)) {
+    for (const extension of extensions) {
+      const lowerCandidate = path.join(dir, `${cmd}${extension.toLowerCase()}`);
+      if (fs.existsSync(lowerCandidate)) {
+        return lowerCandidate;
+      }
+      const upperCandidate = path.join(dir, `${cmd}${extension.toUpperCase()}`);
+      if (fs.existsSync(upperCandidate)) {
+        return upperCandidate;
+      }
+    }
+  }
+
+  return cmd;
+}
+
+function commandOptions(cmd, options) {
+  if (process.platform === "win32" && /\.(?:bat|cmd)$/i.test(cmd)) {
+    return { ...options, shell: true };
+  }
+  return options;
+}
+
 function interpolate(template, taskDir, artifactFile) {
   const artifactStem = artifactFile ? path.basename(artifactFile, path.extname(artifactFile)) : "";
   return template

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

@@ -121,8 +121,8 @@ 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
-- Publish the `{analysis-artifact}` comment
 - Create or update the `<!-- sync-issue:{task-id}:task -->` comment (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

@@ -121,8 +121,8 @@ 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`
-- 发布 `{analysis-artifact}` 评论
 - 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 发布 `{analysis-artifact}` 评论
 
 ### 7. 完成校验
 

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

@@ -95,8 +95,8 @@ 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` first and complete upstream repository detection plus permission detection):
 - Set `status: in-progress` by following issue-sync.md
-- Publish the `{implementation-artifact}` comment
 - Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Publish the `{implementation-artifact}` comment
 
 ### 10. Verification Gate
 

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

@@ -95,8 +95,8 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续；执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测）：
 - 按 issue-sync.md 设置 `status: in-progress`
-- 发布 `{implementation-artifact}` 评论
 - 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 发布 `{implementation-artifact}` 评论
 
 ### 10. 完成校验
 

package/templates/.agents/skills/import-issue/SKILL.en.md

@@ -74,7 +74,14 @@ Update `.agents/workspace/active/{task-id}/task.md`:
 
 If task.md contains a valid `issue_number`, use the Issue update command from `.agents/rules/issue-pr-commands.md` to add the current executor as an assignee. The behavioral boundary still follows `.agents/rules/issue-sync.md`.
 
-### 6. Verification Gate
+### 6. Sync to the Issue
+
+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
+- Check the Issue's current milestone; if it is unset, read `.agents/rules/milestone-inference.md` and infer plus set the milestone using "Stage 1: `create-issue`". If `has_triage=false` or the inference is uncertain, skip and continue
+- Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+
+### 7. Verification Gate
 
 Run the verification gate to confirm the task artifact and sync state are valid:
 
@@ -89,7 +96,7 @@ Handle the result as follows:
 
 Keep the gate output in your reply as fresh evidence. Do not claim completion without output from this run.
 
-### 7. Inform User
+### 8. Inform User
 
 > Execute this step only after the verification gate passes.
 
@@ -119,6 +126,7 @@ Next step - run requirements analysis:
 - [ ] Updated `current_step` to requirement-analysis
 - [ ] Updated `updated_at` to the current time
 - [ ] Appended an Activity Log entry to task.md
+- [ ] Synced the task comment to the Issue
 - [ ] Informed the user of the next step (must include all TUI command formats; do not filter)
 - [ ] **Did not modify any business code**
 

package/templates/.agents/skills/import-issue/SKILL.zh-CN.md

@@ -74,7 +74,14 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 
 如果 task.md 中存在有效的 `issue_number`，按 `.agents/rules/issue-pr-commands.md` 的 Issue 更新命令为当前执行者添加 assignee；Assignee 同步的边界仍遵循 `.agents/rules/issue-sync.md`。
 
-### 6. 完成校验
+### 6. 同步到 Issue
+
+如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：
+- 执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测
+- 检查 Issue 当前 milestone；如果未设置，先读取 `.agents/rules/milestone-inference.md`，按其中的「阶段 1：`create-issue`」规则推断并设置 milestone；如果 `has_triage=false` 或推断不确定，跳过并继续
+- 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+
+### 7. 完成校验
 
 运行完成校验，确认任务产物和同步状态符合规范：
 
@@ -89,7 +96,7 @@ node .agents/scripts/validate-artifact.js gate import-issue .agents/workspace/ac
 
 将校验输出保留在回复中作为当次验证输出。没有当次校验输出，不得声明完成。
 
-### 7. 告知用户
+### 8. 告知用户
 
 > 仅在校验通过后执行本步骤。
 
@@ -119,6 +126,7 @@ Issue #{number} 已导入。
 - [ ] 更新了 `current_step` 为 requirement-analysis
 - [ ] 更新了 `updated_at` 为当前时间
 - [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 同步了 task 评论到 Issue
 - [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
 - [ ] **没有修改任何业务代码**
 

package/templates/.agents/skills/import-issue/config/verify.json

@@ -22,7 +22,8 @@
     },
     "platform-sync": {
       "when": "issue_number_exists",
-      "issue_must_exist": true
+      "issue_must_exist": true,
+      "verify_task_comment_content": true
     }
   }
 }

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

@@ -99,8 +99,8 @@ 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
-- Publish the `{plan-artifact}` comment
 - Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Publish the `{plan-artifact}` comment
 
 ### 8. Verification Gate
 

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

@@ -99,8 +99,8 @@ 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`
-- 发布 `{plan-artifact}` 评论
 - 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 发布 `{plan-artifact}` 评论
 
 ### 8. 完成校验
 

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

@@ -62,8 +62,8 @@ Update 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: in-progress` by following issue-sync.md
-- Publish the `{refinement-artifact}` comment
 - Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Publish the `{refinement-artifact}` comment
 
 ### 7. Verification Gate
 

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

@@ -62,8 +62,8 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：
 - 执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测
 - 按 issue-sync.md 设置 `status: in-progress`
-- 发布 `{refinement-artifact}` 评论
 - 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 发布 `{refinement-artifact}` 评论
 
 ### 7. 完成校验
 

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

@@ -56,8 +56,8 @@ Update task.md and append:
 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: in-progress` by following issue-sync.md
-- Publish the `{review-artifact}` comment
 - Create or update the `<!-- sync-issue:{task-id}:task -->` comment (follow the task.md comment sync rule in issue-sync.md)
+- Publish the `{review-artifact}` comment
 
 ### 7. Verification Gate
 

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

@@ -56,8 +56,8 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 如果 task.md 中存在有效的 `issue_number`，执行以下同步操作（任一失败则跳过并继续）：
 - 执行前先读取 `.agents/rules/issue-sync.md`，完成 upstream 仓库检测和权限检测
 - 按 issue-sync.md 设置 `status: in-progress`
-- 发布 `{review-artifact}` 评论
 - 创建或更新 `<!-- sync-issue:{task-id}:task -->` 评论（按 issue-sync.md 的 task.md 评论同步规则）
+- 发布 `{review-artifact}` 评论
 
 ### 7. 完成校验
 

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

@@ -15,6 +15,7 @@
 
 import childProcess from 'node:child_process';
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -77,7 +78,7 @@ const DEFAULTS = {
   }
 };
 
-const INSTALLER_VERSION = "v0.5.5";
+const INSTALLER_VERSION = "v0.5.6";
 const PACKAGE_NAME = '@fitlab-ai/agent-infra';
 // Add a new identifier here only after shipping matching .{platform}. template variants.
 const KNOWN_PLATFORMS = new Set(['github']);
@@ -124,6 +125,292 @@ function removeEmptyDirs(dir) {
   }
 }
 
+function parseSkillFrontmatter(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/);
+  if (!match) return {};
+
+  const result = {};
+  const lines = match[1].split(/\r?\n/);
+  const normalizeValue = (value) => value.replace(/^["']|["']$/g, '').trim();
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    const pair = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!pair) continue;
+
+    const [, key, rawValue] = pair;
+    if (rawValue === '>') {
+      const block = [];
+      for (let offset = index + 1; offset < lines.length; offset += 1) {
+        const nextLine = lines[offset];
+        if (!/^\s+/.test(nextLine)) break;
+
+        block.push(nextLine.trim());
+        index = offset;
+      }
+      result[key] = block.join(' ').trim();
+      continue;
+    }
+
+    result[key] = normalizeValue(rawValue);
+  }
+
+  return result;
+}
+
+function listTemplateSkillNames(templateRoot) {
+  const templateSkillsDir = path.join(templateRoot, '.agents/skills');
+  if (!fs.existsSync(templateSkillsDir)) return new Set();
+
+  return new Set(
+    fs.readdirSync(templateSkillsDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+  );
+}
+
+function detectCustomSkills(projectRoot, templateSkillNames) {
+  const skillsDir = path.join(projectRoot, '.agents/skills');
+  if (!fs.existsSync(skillsDir)) return [];
+
+  return fs.readdirSync(skillsDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && !templateSkillNames.has(entry.name))
+    .map((entry) => {
+      const skillMd = path.join(skillsDir, entry.name, 'SKILL.md');
+      if (!fs.existsSync(skillMd)) return null;
+
+      const meta = parseSkillFrontmatter(skillMd);
+      return {
+        dirName: entry.name,
+        name: meta.name || entry.name,
+        description: meta.description || '',
+        args: meta.args || null
+      };
+    })
+    .filter(Boolean)
+    .sort((left, right) => left.dirName.localeCompare(right.dirName));
+}
+
+function isCustomProtected(targetPath, customSkills, project) {
+  const normalized = norm(targetPath);
+
+  return customSkills.some(({ dirName }) => (
+    normalized.startsWith(`.agents/skills/${dirName}/`) ||
+    normalized === `.claude/commands/${dirName}.md` ||
+    normalized === `.opencode/commands/${dirName}.md` ||
+    normalized === '.gemini/commands/' + project + '/' + dirName + '.toml'
+  ));
+}
+
+function expandHome(inputPath) {
+  if (inputPath === '~') return os.homedir();
+  if (inputPath.startsWith('~/')) {
+    return path.join(os.homedir(), inputPath.slice(2));
+  }
+
+  return path.resolve(inputPath);
+}
+
+function writeIfChanged(projectRoot, targetPath, content, reportBucket) {
+  const fullPath = path.join(projectRoot, targetPath);
+  const exists = fs.existsSync(fullPath);
+
+  if (exists && fs.readFileSync(fullPath, 'utf8') === content) {
+    reportBucket.unchanged.push(targetPath);
+    return;
+  }
+
+  const dir = path.dirname(fullPath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(fullPath, content, 'utf8');
+
+  (exists ? reportBucket.updated : reportBucket.generated).push(targetPath);
+}
+
+function syncCustomSkillSources(projectRoot, sources, report, templateSkillNames) {
+  const skillsDir = path.join(projectRoot, '.agents/skills');
+  const syncedSkills = new Map();
+
+  for (const source of sources) {
+    if (source?.type !== 'local') continue;
+    if (typeof source.path !== 'string' || source.path.trim() === '') {
+      report.custom.sourceErrors.push({ source: String(source?.path || ''), reason: 'invalid path' });
+      continue;
+    }
+
+    const srcDir = expandHome(source.path);
+    if (!fs.existsSync(srcDir) || !fs.statSync(srcDir).isDirectory()) {
+      report.custom.sourceErrors.push({ source: source.path, reason: 'directory not found' });
+      continue;
+    }
+
+    for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      if (templateSkillNames.has(entry.name)) {
+        report.custom.sourceErrors.push({
+          source: source.path,
+          reason: `skill ${entry.name} conflicts with built-in skill`
+        });
+        continue;
+      }
+
+      const skillSrcDir = path.join(srcDir, entry.name);
+      const skillMd = path.join(skillSrcDir, 'SKILL.md');
+      if (!fs.existsSync(skillMd)) continue;
+
+      const skillDstDir = path.join(skillsDir, entry.name);
+      const trackedFiles = syncedSkills.get(entry.name) || new Set();
+      syncedSkills.set(entry.name, trackedFiles);
+
+      for (const srcFile of walkDir(skillSrcDir)) {
+        const relPath = norm(path.relative(skillSrcDir, srcFile));
+        const dstFile = path.join(skillDstDir, relPath);
+        const projectPath = norm(path.relative(projectRoot, dstFile));
+        const srcContent = fs.readFileSync(srcFile);
+        const existed = fs.existsSync(dstFile);
+
+        trackedFiles.add(relPath);
+
+        if (existed) {
+          const dstContent = fs.readFileSync(dstFile);
+          if (srcContent.equals(dstContent)) {
+            report.custom.unchanged.push(projectPath);
+            continue;
+          }
+        }
+
+        const dir = path.dirname(dstFile);
+        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(dstFile, srcContent);
+
+        (existed ? report.custom.updated : report.custom.generated).push(projectPath);
+      }
+    }
+  }
+
+  return syncedSkills;
+}
+
+function cleanStaleSyncedFiles(projectRoot, syncedSkills, report) {
+  const skillsDir = path.join(projectRoot, '.agents/skills');
+
+  for (const [skillName, expectedFiles] of syncedSkills) {
+    const skillDir = path.join(skillsDir, skillName);
+    if (!fs.existsSync(skillDir)) continue;
+
+    const actualFiles = walkDir(skillDir).map((filePath) => norm(path.relative(skillDir, filePath)));
+    const removedBefore = report.custom.removed.length;
+
+    for (const actualFile of actualFiles) {
+      if (expectedFiles.has(actualFile)) continue;
+
+      const staleFile = path.join(skillDir, actualFile);
+      fs.unlinkSync(staleFile);
+      report.custom.removed.push(norm(path.relative(projectRoot, staleFile)));
+    }
+
+    if (report.custom.removed.length > removedBefore) {
+      removeEmptyDirs(skillDir);
+    }
+  }
+}
+
+function generateClaudeCommand(skill, lang) {
+  const isZhCN = lang === 'zh-CN';
+  const lines = ['---', `description: ${JSON.stringify(skill.description)}`];
+
+  if (skill.args) {
+    lines.push(`usage: ${JSON.stringify(`/${skill.dirName} ${skill.args}`)}`);
+  }
+
+  lines.push('---', '');
+  lines.push(
+    isZhCN
+      ? `读取并执行 \`.agents/skills/${skill.dirName}/SKILL.md\` 中的 ${skill.dirName} 技能。`
+      : `Read and execute the ${skill.dirName} skill from \`.agents/skills/${skill.dirName}/SKILL.md\`.`
+  );
+  lines.push('');
+  lines.push(isZhCN ? '严格按照技能中定义的所有步骤执行。' : 'Follow all steps defined in the skill exactly.');
+
+  return `${lines.join('\n')}\n`;
+}
+
+function generateGeminiCommand(skill, lang) {
+  const isZhCN = lang === 'zh-CN';
+  const promptLines = [];
+
+  if (skill.args) {
+    promptLines.push(isZhCN ? '参数：{{args}}' : 'Arguments: {{args}}');
+    promptLines.push('');
+  }
+
+  promptLines.push(
+    isZhCN
+      ? `读取并执行 \`.agents/skills/${skill.dirName}/SKILL.md\` 中的 ${skill.dirName} 技能。`
+      : `Read and execute the ${skill.dirName} skill from \`.agents/skills/${skill.dirName}/SKILL.md\`.`
+  );
+  promptLines.push('');
+  promptLines.push(isZhCN ? '严格按照技能中定义的所有步骤执行。' : 'Follow all steps defined in the skill exactly.');
+
+  return [
+    `description = ${JSON.stringify(skill.description)}`,
+    'prompt = """',
+    ...promptLines,
+    '"""'
+  ].join('\n') + '\n';
+}
+
+function generateOpenCodeCommand(skill, lang) {
+  const isZhCN = lang === 'zh-CN';
+  const lines = [
+    '---',
+    `description: ${JSON.stringify(skill.description)}`,
+    'agent: general',
+    'subtask: false',
+    '---',
+    ''
+  ];
+
+  if (skill.args) {
+    lines.push(isZhCN ? '参数：$ARGUMENTS' : 'Arguments: $ARGUMENTS');
+    lines.push('');
+  }
+
+  lines.push(
+    isZhCN
+      ? `读取并执行 \`.agents/skills/${skill.dirName}/SKILL.md\` 中的 ${skill.dirName} 技能。`
+      : `Read and execute the ${skill.dirName} skill from \`.agents/skills/${skill.dirName}/SKILL.md\`.`
+  );
+  lines.push('');
+  lines.push(isZhCN ? '严格按照技能中定义的所有步骤执行。' : 'Follow all steps defined in the skill exactly.');
+
+  return `${lines.join('\n')}\n`;
+}
+
+function generateCustomCommands(projectRoot, customSkills, project, lang, report) {
+  for (const skill of customSkills) {
+    writeIfChanged(
+      projectRoot,
+      `.claude/commands/${skill.dirName}.md`,
+      generateClaudeCommand(skill, lang),
+      report.custom.commands
+    );
+    writeIfChanged(
+      projectRoot,
+      '.gemini/commands/' + project + '/' + skill.dirName + '.toml',
+      generateGeminiCommand(skill, lang),
+      report.custom.commands
+    );
+    writeIfChanged(
+      projectRoot,
+      `.opencode/commands/${skill.dirName}.md`,
+      generateOpenCodeCommand(skill, lang),
+      report.custom.commands
+    );
+  }
+}
+
 function matchesAny(rel, patterns) {
   const n = norm(rel);
   return patterns.some(p => norm(p) === n || globMatch(p, n));
@@ -412,6 +699,8 @@ function syncTemplates(projectRoot, templateRootOverride) {
   const { project, org, language: lang = 'en' } = cfg;
   const platformType = cfg.platform?.type || DEFAULTS.platform.type;
   const vars = { project, org };
+  const templateSkillNames = listTemplateSkillNames(templateRoot);
+  const protectedCustomSkills = detectCustomSkills(projectRoot, templateSkillNames);
 
   const managed = [...(cfg.files.managed || [])];
   const merged  = [...(cfg.files.merged  || [])];
@@ -422,6 +711,15 @@ function syncTemplates(projectRoot, templateRootOverride) {
     templateRoot: norm(templateRoot),
     registryAdded: [],
     managed: { written: [], created: [], unchanged: [], skippedMerged: [], removed: [] },
+    custom: {
+      detected: [],
+      generated: [],
+      updated: [],
+      unchanged: [],
+      removed: [],
+      sourceErrors: [],
+      commands: { generated: [], updated: [], unchanged: [] }
+    },
     ejected: { created: [], skipped: [] },
     merged:  { pending: [] },
     configUpdated: false,
@@ -497,6 +795,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
         for (const projFile of projFiles) {
           if (expectedTargets.has(projFile)) continue;
           if (projFile === configPathRel) continue;
+          if (isCustomProtected(projFile, protectedCustomSkills, project)) continue;
           if (matchesAny(projFile, merged) || matchesAny(projFile, ejected)) continue;
 
           fs.unlinkSync(path.join(projectRoot, projFile));
@@ -509,6 +808,16 @@ function syncTemplates(projectRoot, templateRootOverride) {
     }
   }
 
+  const sources = Array.isArray(cfg.skills?.sources) ? cfg.skills.sources : [];
+  if (sources.length > 0) {
+    const syncedSkills = syncCustomSkillSources(projectRoot, sources, report, templateSkillNames);
+    cleanStaleSyncedFiles(projectRoot, syncedSkills, report);
+  }
+
+  const customSkills = detectCustomSkills(projectRoot, templateSkillNames);
+  report.custom.detected = customSkills.map((skill) => skill.dirName);
+  generateCustomCommands(projectRoot, customSkills, project, lang, report);
+
   for (const entry of ejected) {
     const dstFull = path.join(projectRoot, entry);
     if (fs.existsSync(dstFull)) {
@@ -557,6 +866,11 @@ function syncTemplates(projectRoot, templateRootOverride) {
     report.managed.written.length +
     report.managed.created.length +
     report.managed.removed.length +
+    report.custom.generated.length +
+    report.custom.updated.length +
+    report.custom.removed.length +
+    report.custom.commands.generated.length +
+    report.custom.commands.updated.length +
     report.ejected.created.length +
     report.registryAdded.length
   ) > 0;

package/templates/.github/workflows/metadata-sync.yml

@@ -56,7 +56,7 @@ jobs:
 
       - name: Checkout shared scripts
         if: steps.metadata.outputs.is_task_comment == 'true' && steps.metadata.outputs.type != ''
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           sparse-checkout: .github/scripts
           sparse-checkout-cone-mode: false

package/templates/.github/workflows/pr-label.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout base branch
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Sync in-labels
         env: