@fitlab-ai/agent-infra 0.5.1 → 0.5.3

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">Agent Infra</h1>
 
 <p align="center">
-  The missing collaboration layer for AI coding agents — unified skills and workflows for Claude Code, Codex, Gemini CLI, and OpenCode.
+  Collaboration infrastructure for AI coding agents — skills, workflows, and sandboxes for Claude Code, Codex, Gemini CLI, and OpenCode.
 </p>
 
 <p align="center">
@@ -29,12 +29,26 @@
 
 Teams increasingly mix Claude Code, Codex, Gemini CLI, OpenCode, and other AI TUIs in the same repository, but each tool tends to introduce its own commands, prompts, and local conventions. Without a shared layer, the result is fragmented workflows, duplicated setup, and task history that is difficult to audit.
 
-agent-infra standardizes that collaboration surface. It gives every supported AI TUI the same task lifecycle, the same skill vocabulary, the same project governance files, and the same upgrade path, so teams can switch tools without rebuilding process from scratch.
+agent-infra standardizes that shared infrastructure. It gives every supported AI TUI the same task lifecycle, the same skill vocabulary, the same project governance files, isolated development sandboxes, and the same upgrade path, so teams can switch tools without rebuilding process from scratch.
 
 <a id="see-it-in-action"></a>
 
 ## See it in Action
 
+### Install & Initialize
+
+<p align="center">
+  <img src="./assets/demo-init.gif" alt="CLI install and initialize demo" width="100%" style="max-width: 720px;">
+</p>
+
+Once initialized, open the project in your AI TUI and install the latest skills:
+
+```bash
+/update-agent-infra
+```
+
+> AI reads `.agents/.airc.json`, auto-locates the installed template root, and syncs the latest skill manifests, managed files, and registry deterministically via `sync-templates.js`.
+
 **Scenario**: Issue #42 reports *"Login API returns 500 when email contains a plus sign"*. Here is the full fix lifecycle — AI does the heavy lifting, you stay in control:
 
 ```bash
@@ -396,7 +410,7 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.5.1",
+  "templateVersion": "v0.5.3",
   "files": {
     "managed": [
       ".agents/workspace/README.md",

package/README.zh-CN.md

@@ -5,7 +5,7 @@
 <h1 align="center">Agent Infra</h1>
 
 <p align="center">
-  AI 编程代理之间缺失的协作层 —— 为 Claude Code、Codex、Gemini CLI、OpenCode 提供统一的 skills 和工作流。
+  AI 编程代理的协作基础设施 —— 为 Claude Code、Codex、Gemini CLI、OpenCode 提供 skills、工作流和沙箱。
 </p>
 
 <p align="center">
@@ -29,12 +29,26 @@
 
 越来越多的团队会在同一个仓库里混用 Claude Code、Codex、Gemini CLI、OpenCode 等 AI TUI，但每个工具往往都会带来自己的命令体系、提示词习惯和本地约定。缺少共享层时，结果通常是工作流割裂、初始化重复、任务历史难以追踪。
 
-agent-infra 的目标就是把这层协作面标准化。它为所有支持的 AI TUI 提供统一的任务生命周期、统一的 skill 词汇、统一的项目治理文件以及统一的升级路径，让团队切换工具时不必重新发明流程。
+agent-infra 的目标就是把这层共享基础设施标准化。它为所有支持的 AI TUI 提供统一的任务生命周期、统一的 skill 词汇、统一的项目治理文件、隔离的开发沙箱以及统一的升级路径，让团队切换工具时不必重新发明流程。
 
 <a id="see-it-in-action"></a>
 
 ## 实战演示
 
+### 安装与初始化
+
+<p align="center">
+  <img src="./assets/demo-init.gif" alt="CLI 安装初始化演示" width="100%" style="max-width: 720px;">
+</p>
+
+完成初始化后，在你的 AI TUI 中打开项目并安装最新 skills：
+
+```bash
+/update-agent-infra
+```
+
+> AI 读取 `.agents/.airc.json`，自动定位已安装的模板根目录，并通过 `sync-templates.js` 确定性地同步最新的 skill 清单、managed 文件和注册表。
+
 **场景**：Issue #42 报告 *"登录接口在邮箱包含加号时返回 500"*。以下是完整的修复流程 —— AI 执行主要工作，你掌控方向：
 
 ```bash
@@ -396,7 +410,7 @@ import-issue #42                    从 GitHub Issue 导入任务
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.5.1",
+  "templateVersion": "v0.5.3",
   "files": {
     "managed": [
       ".agents/workspace/README.md",

package/lib/defaults.json

@@ -1,4 +1,7 @@
 {
+  "platform": {
+    "type": "github"
+  },
   "sandbox": {
     "runtimes": [
       "node20"

package/lib/init.js

@@ -92,14 +92,22 @@ async function cmdInit() {
   }
 
   let language = await prompt('Language (en / zh)', 'zh');
-  closePrompt();
   if (language === 'zh') language = 'zh-CN';
   if (language !== 'en' && language !== 'zh-CN') {
+    closePrompt();
     err(`Language must be 'en' or 'zh'. Got: ${language}`);
     process.exitCode = 1;
     return;
   }
 
+  const platformType = (await prompt('Platform type', 'github')).trim() || 'github';
+  closePrompt();
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(platformType)) {
+    err(`Platform type must match /^[a-z0-9][a-z0-9-]*$/. Got: ${platformType}`);
+    process.exitCode = 1;
+    return;
+  }
+
   const project = projectName;
   const replacements = { project, org: orgName };
 
@@ -118,9 +126,9 @@ async function cmdInit() {
     geminiSrc = 'update-agent-infra.zh-CN.toml';
     opencodeSrc = 'update-agent-infra.zh-CN.md';
   } else {
-    claudeSrc = 'update-agent-infra.md';
-    geminiSrc = 'update-agent-infra.toml';
-    opencodeSrc = 'update-agent-infra.md';
+    claudeSrc = 'update-agent-infra.en.md';
+    geminiSrc = 'update-agent-infra.en.toml';
+    opencodeSrc = 'update-agent-infra.en.md';
   }
 
   // install skill
@@ -128,7 +136,8 @@ async function cmdInit() {
     path.join(templateDir, '.agents', 'skills', 'update-agent-infra'),
     path.join('.agents', 'skills', 'update-agent-infra'),
     replacements,
-    language
+    language,
+    platformType
   );
   ok('Installed .agents/skills/update-agent-infra/');
 
@@ -161,6 +170,7 @@ async function cmdInit() {
     project: projectName,
     org: orgName,
     language,
+    platform: { type: platformType },
     templateVersion: VERSION,
     sandbox: structuredClone(defaults.sandbox),
     labels: structuredClone(defaults.labels),

package/lib/merge.js

@@ -404,15 +404,22 @@ function removeManifestFiles(rootDir) {
 }
 
 function formatTimestamp(date) {
+  const pad = (value) => String(value).padStart(2, '0');
+  const offsetMinutes = -date.getTimezoneOffset();
+  const sign = offsetMinutes >= 0 ? '+' : '-';
+  const absoluteOffsetMinutes = Math.abs(offsetMinutes);
+  const offsetHours = Math.floor(absoluteOffsetMinutes / 60);
+  const offsetRemainderMinutes = absoluteOffsetMinutes % 60;
+
   return [
     date.getFullYear(),
-    String(date.getMonth() + 1).padStart(2, '0'),
-    String(date.getDate()).padStart(2, '0')
+    pad(date.getMonth() + 1),
+    pad(date.getDate())
   ].join('-') + ' ' + [
-    String(date.getHours()).padStart(2, '0'),
-    String(date.getMinutes()).padStart(2, '0'),
-    String(date.getSeconds()).padStart(2, '0')
-  ].join(':');
+    pad(date.getHours()),
+    pad(date.getMinutes()),
+    pad(date.getSeconds())
+  ].join(':') + `${sign}${pad(offsetHours)}:${pad(offsetRemainderMinutes)}`;
 }
 
 function formatBackupTimestamp(date) {
@@ -485,7 +492,15 @@ function getTaskTimestamp(taskDir) {
 }
 
 function compareTimestamps(left, right) {
-  return left.value.localeCompare(right.value);
+  const normalizeTimestamp = (timestamp) => (timestamp.includes('T') ? timestamp : timestamp.replace(' ', 'T'));
+  const leftMs = Date.parse(normalizeTimestamp(left.value));
+  const rightMs = Date.parse(normalizeTimestamp(right.value));
+
+  if (Number.isNaN(leftMs) || Number.isNaN(rightMs)) {
+    return left.value.localeCompare(right.value);
+  }
+
+  return leftMs - rightMs;
 }
 
 function scanWorkspaceSection(rootDir, sectionName) {

package/lib/render.js

@@ -1,6 +1,10 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
+// Add a new identifier here only after shipping matching .{platform}. template variants.
+const KNOWN_PLATFORMS = new Set(['github']);
+const KNOWN_LANGUAGES = new Set(['en', 'zh-CN']);
+
 function renderFile(src, dst, replacements) {
   if (!fs.existsSync(src)) {
     throw new Error(`Template file not found: ${src}`);
@@ -50,37 +54,95 @@ function containsPlaceholders(src) {
   return content.includes('{{project}}') || content.includes('{{org}}');
 }
 
-function selectLocalizedFiles(srcDir, language) {
-  const selected = new Map();
+function variantExt(relativePath) {
+  return path.extname(relativePath);
+}
 
-  for (const src of walkFiles(srcDir)) {
-    const relativePath = path.relative(srcDir, src);
-    if (relativePath.includes('.zh-CN.')) {
-      continue;
+function variantBase(relativePath) {
+  const ext = variantExt(relativePath);
+  return relativePath.slice(0, -ext.length);
+}
+
+function withVariant(relativePath, variant) {
+  const ext = variantExt(relativePath);
+  const base = variantBase(relativePath);
+  return `${base}.${variant}${ext}`;
+}
+
+function stripVariant(relativePath, variant) {
+  return relativePath.replace(new RegExp(`\\.${variant.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\.`), '.');
+}
+
+function isPlatformVariant(relativePath, platform) {
+  const platforms = new Set([...KNOWN_PLATFORMS, platform]);
+  for (const candidate of platforms) {
+    if (relativePath.includes(`.${candidate}.`)) {
+      return true;
     }
-    selected.set(relativePath, src);
   }
+  return false;
+}
+
+function isLangVariant(relativePath) {
+  for (const lang of KNOWN_LANGUAGES) {
+    if (relativePath.includes(`.${lang}.`)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+function langSelect(relativePaths, language) {
+  const selected = new Map();
 
-  if (language === 'zh-CN') {
-    for (const src of walkFiles(srcDir)) {
-      const relativePath = path.relative(srcDir, src);
-      if (!relativePath.includes('.zh-CN.')) {
-        continue;
+  for (const relativePath of relativePaths) {
+    if (relativePath.includes(`.${language}.`)) {
+      selected.set(stripVariant(relativePath, language), relativePath);
+    } else if (!isLangVariant(relativePath)) {
+      if (!selected.has(relativePath)) {
+        selected.set(relativePath, relativePath);
       }
+    }
+  }
+
+  return selected;
+}
 
-      selected.set(relativePath.replace('.zh-CN.', '.'), src);
+function platformSelect(entries, platform) {
+  const selected = new Map();
+
+  for (const [relativePath, src] of entries) {
+    if (!relativePath.includes(`.${platform}.`)) {
+      continue;
     }
+    selected.set(stripVariant(relativePath, platform), src);
+  }
+
+  for (const [relativePath, src] of entries) {
+    if (selected.has(relativePath)) {
+      continue;
+    }
+    if (isPlatformVariant(relativePath, platform)) {
+      continue;
+    }
+    selected.set(relativePath, src);
   }
 
   return selected;
 }
 
-function copySkillDir(srcDir, dstDir, replacements, language) {
+function selectLocalizedFiles(srcDir, language, platform = 'github') {
+  const relativePaths = walkFiles(srcDir).map((src) => path.relative(srcDir, src));
+  return platformSelect(langSelect(relativePaths, language), platform);
+}
+
+function copySkillDir(srcDir, dstDir, replacements, language, platform = 'github') {
   if (!fs.existsSync(srcDir)) {
     throw new Error(`Template directory not found: ${srcDir}`);
   }
 
-  for (const [relativePath, src] of selectLocalizedFiles(srcDir, language)) {
+  for (const [relativePath, selectedRelativePath] of selectLocalizedFiles(srcDir, language, platform)) {
+    const src = path.join(srcDir, selectedRelativePath);
     const dst = path.join(dstDir, relativePath);
     if (containsPlaceholders(src)) {
       renderFile(src, dst, replacements);

package/lib/sandbox/commands/enter.js

@@ -4,12 +4,28 @@ import { runInteractive, runSafe } from '../shell.js';
 import { resolveTaskBranch } from '../task-resolver.js';
 
 const USAGE = `Usage: ai sandbox exec <branch> [cmd...]`;
-export const TMUX_INTERACTIVE_TIP =
-  "tip: for long-running TUI sessions, run 'tmux new -s work' to survive disconnects (reattach with 'tmux a -t work')\n";
+export const TMUX_ENTRY_SCRIPT = `
+SESSION=work
 
-export function printInteractiveEntryTip(stream = process.stderr) {
-  stream.write(TMUX_INTERACTIVE_TIP);
-}
+if ! command -v tmux >/dev/null 2>&1; then
+  exec bash
+fi
+
+if ! tmux has-session -t "$SESSION" 2>/dev/null; then
+  exec tmux new-session -s "$SESSION"
+fi
+
+tmux list-sessions -F '#{session_name} #{session_attached}' 2>/dev/null | \\
+  while read -r name attached; do
+    [ "$name" = "$SESSION" ] && continue
+    case "$name" in
+      ''|*[!0-9]*) continue ;;
+    esac
+    [ "$attached" = "0" ] && tmux kill-session -t "$name" 2>/dev/null || true
+  done
+
+exec tmux new-session -t "$SESSION"
+`.trim();
 
 // Terminal-detection variables that interactive TUIs (e.g. claude-code)
 // inspect to enable progressive enhancements such as the kitty keyboard
@@ -56,8 +72,7 @@ export function enter(args) {
 
   const envFlags = terminalEnvFlags();
   if (cmd.length === 0) {
-    printInteractiveEntryTip();
-    return runInteractive('docker', ['exec', '-it', ...envFlags, container, 'bash']);
+    return runInteractive('docker', ['exec', '-it', ...envFlags, container, 'bash', '-c', TMUX_ENTRY_SCRIPT]);
   }
 
   return runInteractive('docker', ['exec', '-it', ...envFlags, container, ...cmd]);

package/lib/sandbox/commands/rm.js

@@ -87,7 +87,7 @@ async function rmOne(config, tools, branch) {
 
       const shouldDeleteBranch = await p.confirm({
         message: `Also delete local branch '${effectiveBranch}'?`,
-        initialValue: false
+        initialValue: true
       });
 
       if (!p.isCancel(shouldDeleteBranch) && shouldDeleteBranch) {

package/lib/sandbox/runtimes/base.dockerfile

@@ -11,8 +11,10 @@ RUN (groupadd -g ${HOST_GID} devuser || true) && \
     useradd -u ${HOST_UID} -g ${HOST_GID} -m -s /bin/bash devuser
 
 RUN apt-get update && apt-get install -y \
-    curl wget git vim tmux file \
+    curl wget git vim file \
     build-essential ca-certificates gnupg lsb-release \
+    libevent-core-2.1-7 libncursesw6 libtinfo6 \
+    pkg-config bison libevent-dev libncurses-dev \
     locales \
     && locale-gen en_US.UTF-8 \
     && (curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
@@ -20,8 +22,32 @@ RUN apt-get update && apt-get install -y \
     && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
         > /etc/apt/sources.list.d/github-cli.list \
     && apt-get update && apt-get install -y gh \
+    && TMUX_VERSION=3.6a \
+    && wget -qO /tmp/tmux.tar.gz \
+        "https://github.com/tmux/tmux/releases/download/${TMUX_VERSION}/tmux-${TMUX_VERSION}.tar.gz" \
+    && tar xzf /tmp/tmux.tar.gz -C /tmp \
+    && cd /tmp/tmux-${TMUX_VERSION} \
+    && ./configure --prefix=/usr/local \
+    && make -j"$(nproc)" \
+    && make install \
+    && cd / \
+    && rm -rf /tmp/tmux.tar.gz /tmp/tmux-${TMUX_VERSION} \
+    && apt-get purge -y pkg-config bison libevent-dev libncurses-dev \
+    && apt-get autoremove -y \
+    && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
 
+# Enable extended keys in CSI u format so Shift+Enter and other modified
+# keys are forwarded through tmux. Preserve terminal-detection variables
+# injected at `docker exec` time when new tmux sessions are created.
+RUN printf '%s\n' \
+      'set -g extended-keys always' \
+      'set -g extended-keys-format csi-u' \
+      "set -as terminal-features 'xterm*:extkeys'" \
+      "set -ga update-environment 'TERM_PROGRAM TERM_PROGRAM_VERSION LC_TERMINAL LC_TERMINAL_VERSION'" \
+      'set -g mouse on' \
+    > /etc/tmux.conf
+
 ENV LANG=en_US.UTF-8
 ENV LC_ALL=en_US.UTF-8
 ENV TERM=xterm-256color

package/lib/update.js

@@ -81,6 +81,7 @@ async function cmdUpdate() {
   // read project config
   const config = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
   const { project, org, language } = config;
+  const platformType = config.platform?.type || defaults.platform.type;
   const replacements = { project, org };
 
   info(`Updating seed files for: ${project}`);
@@ -93,9 +94,9 @@ async function cmdUpdate() {
     geminiSrc = 'update-agent-infra.zh-CN.toml';
     opencodeSrc = 'update-agent-infra.zh-CN.md';
   } else {
-    claudeSrc = 'update-agent-infra.md';
-    geminiSrc = 'update-agent-infra.toml';
-    opencodeSrc = 'update-agent-infra.md';
+    claudeSrc = 'update-agent-infra.en.md';
+    geminiSrc = 'update-agent-infra.en.toml';
+    opencodeSrc = 'update-agent-infra.en.md';
   }
 
   // update skill
@@ -103,7 +104,8 @@ async function cmdUpdate() {
     path.join(templateDir, '.agents', 'skills', 'update-agent-infra'),
     path.join('.agents', 'skills', 'update-agent-infra'),
     replacements,
-    language
+    language,
+    platformType
   );
   ok('Updated .agents/skills/update-agent-infra/');
   try {
@@ -139,10 +141,16 @@ async function cmdUpdate() {
   // sync file registry
   const { added, changed } = syncFileRegistry(config);
   const hasNewEntries = added.managed.length > 0 || added.merged.length > 0;
+  const platformAdded = !config.platform;
   const sandboxAdded = !config.sandbox;
   const labelsAdded = !config.labels;
   let configChanged = changed;
 
+  if (platformAdded) {
+    config.platform = structuredClone(defaults.platform);
+    configChanged = true;
+  }
+
   if (sandboxAdded) {
     config.sandbox = structuredClone(defaults.sandbox);
     configChanged = true;
@@ -163,7 +171,10 @@ async function cmdUpdate() {
       for (const entry of added.merged) {
         ok(`  merged: ${entry}`);
       }
-    } else if (sandboxAdded || labelsAdded) {
+    } else if (platformAdded || sandboxAdded || labelsAdded) {
+      if (platformAdded) {
+        info(`Default platform config added to ${CONFIG_PATH}.`);
+      }
       if (sandboxAdded) {
         info(`Default sandbox config added to ${CONFIG_PATH}.`);
       }
@@ -179,6 +190,9 @@ async function cmdUpdate() {
     if (hasNewEntries && labelsAdded) {
       info(`Default labels.in config added to ${CONFIG_PATH}.`);
     }
+    if (hasNewEntries && platformAdded) {
+      info(`Default platform config added to ${CONFIG_PATH}.`);
+    }
     fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf8');
     ok(`Updated ${CONFIG_PATH}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -46,6 +46,7 @@
   },
   "scripts": {
     "build": "node scripts/build-inline.js",
+    "demo:regen": "vhs assets/demo-init.tape",
     "prepare": "git config core.hooksPath .github/hooks || true",
     "test": "node scripts/build-inline.js --check && node --test tests/cli/*.test.js tests/templates/*.test.js tests/core/*.test.js",
     "prepublishOnly": "node scripts/build-inline.js --check && node --test tests/cli/*.test.js tests/templates/*.test.js tests/core/*.test.js"

package/templates/.agents/{README.md → README.en.md}

@@ -100,15 +100,25 @@ Each AI tool has different strengths. Use them accordingly:
 
 ## Label Conventions
 
-GitHub Labels in this project use the following prefixes, each with a defined scope:
+This project uses the following collaboration label prefixes, each with a defined scope:
 
 | Label prefix | Issue | PR | Notes |
 |---|---|---|---|
-| `type:` | — | Yes | Issues use the native GitHub Type field; PRs use `type:` labels for changelog generation and categorization |
+| `type:` | — | Yes | Issues use the platform's native type/category field when available; PRs use `type:` labels for changelog generation and categorization |
 | `status:` | Yes | — | PRs already have their own state flow (Open / Draft / Merged / Closed); Issues use `status:` labels for project tracking states |
 | `in:` | Yes | Yes | Both Issues and PRs can be filtered by module |
 
-Initialize the label set with the `/init-labels` command.
+The default GitHub setup initializes these labels with the `/init-labels` command.
+
+## Private Platform Extensions
+
+To adapt agent-infra to a private code-hosting platform:
+
+1. Set `.agents/.airc.json` `platform.type` to a stable identifier such as `my-platform`.
+2. Copy the generated rule files in `.agents/rules/` and adapt them to your platform's CLI or API while keeping the runtime filenames unchanged.
+3. Add the customized rule files to `.agents/.airc.json` `files.ejected` so future `agent-infra update` runs do not overwrite them.
+4. If you maintain a fork of the template source, add matching `.{platform}.` template variants before adding that platform identifier to the sync logic.
+5. Validate the customized workflow on a test task before rolling it out broadly.
 
 ## Skill Authoring Conventions
 

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

@@ -100,15 +100,25 @@
 
 ## Label 规范
 
-本项目的 GitHub Labels 按以下前缀分类，各前缀有明确的适用范围：
+本项目的协作 labels 按以下前缀分类，各前缀有明确的适用范围：
 
 | Label 前缀 | Issue | PR | 说明 |
 |---|---|---|---|
-| `type:` | — | Yes | Issue 使用 GitHub 原生 Type 字段；PR 无原生类型字段，通过 `type:` label 驱动 changelog 和分类 |
+| `type:` | — | Yes | Issue 优先使用平台原生的类型/分类字段；PR 无原生类型字段时，通过 `type:` label 驱动 changelog 和分类 |
 | `status:` | Yes | — | PR 有自身状态流转（Open / Draft / Merged / Closed）；Issue 使用 `status:` label 标记等待反馈、已确认等项目管理状态 |
 | `in:` | Yes | Yes | Issue 和 PR 均可按模块筛选 |
 
-初始化 Label 体系：使用 `/init-labels` 命令一次性创建标准 labels。
+默认 GitHub 配置下，可使用 `/init-labels` 命令一次性创建标准 labels。
+
+## 私有平台扩展
+
+如需将 agent-infra 接入私有代码托管平台：
+
+1. 在 `.agents/.airc.json` 中把 `platform.type` 设为稳定标识，例如 `my-platform`。
+2. 以 `.agents/rules/` 下已生成的规则文件为起点，改写为你的平台 CLI 或 API 调用，同时保持运行时文件名不变。
+3. 将这些自定义规则文件加入 `.agents/.airc.json` 的 `files.ejected`，避免后续执行 `agent-infra update` 时被覆盖。
+4. 如果你维护的是模板源码分支或私有 fork，需要先补齐对应的 `.{platform}.` 模板变体，再把该平台标识加入模板同步逻辑。
+5. 在正式推广前，先用一个测试任务完整验证工作流和 gate 校验。
 
 ## Skill 编写规范