@fitlab-ai/agent-infra 0.7.0 → 0.7.1

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

@@ -13,6 +13,10 @@ Import the specified Issue and create a task. Argument: issue number.
 - Do not write or modify business code; import only
 - After executing this skill, you **must** immediately update task status
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Execution Flow
 
 ### 1. Retrieve Issue Information
@@ -119,6 +123,14 @@ If task.md contains a valid `issue_number`, perform these sync actions (skip and
 
 ### 7. Verification Gate
 
+**Allocate short id first** (writes `short_id` back to task.md and the registry entry; the validation gate will read it):
+
+```bash
+node .agents/scripts/task-short-id.js alloc "$task_id"
+```
+
+If this fails (non-zero exit), follow the message — archive some active tasks or raise `task.shortIdLength` — and do NOT continue.
+
 Run the verification gate to confirm the task artifact and sync state are valid:
 
 ```bash
@@ -155,6 +167,8 @@ Next step - run requirements analysis:
   - Codex CLI: $analyze-task {task-id}
 ```
 
+
+
 ## Completion Checklist
 
 - [ ] Created the task file `.agents/workspace/active/{task-id}/task.md`

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

@@ -13,6 +13,10 @@ description: "从 Issue 导入并创建任务"
 - 不要编写或修改业务代码。仅做导入
 - 执行本技能后，你**必须**立即更新任务状态
 
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
+
 ## 执行流程
 
 ### 1. 获取 Issue 信息
@@ -119,6 +123,14 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 
 ### 7. 完成校验
 
+**先调用短号分配**（保证 `short_id` 写回 task.md + 注册表 entry 已在；完成校验阶段会读取）：
+
+```bash
+node .agents/scripts/task-short-id.js alloc "$task_id"
+```
+
+如失败（退出码非 0），按提示「归档若干任务」或「调高 task.shortIdLength」处理；不要继续执行后续步骤。
+
 运行完成校验，确认任务产物和同步状态符合规范：
 
 ```bash
@@ -155,6 +167,8 @@ Issue #{number} 已导入。
   - Codex CLI：$analyze-task {task-id}
 ```
 
+
+
 ## 完成检查清单
 
 - [ ] 创建了任务文件 `.agents/workspace/active/{task-id}/task.md`

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

@@ -27,6 +27,10 @@ tail .agents/workspace/active/{task-id}/task.md
 
 Before the state check is complete, do not make external-state assertions such as "the code is unchanged", "tests passed", or "there are no other references", including in reasoning. This gate is only a structural floor; evidence pairing and authenticity still require the report template and review discipline.
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Steps
 
 ### 1. Verify Prerequisites

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

@@ -27,8 +27,11 @@ tail .agents/workspace/active/{task-id}/task.md
 
 状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。
 
-## 执行步骤
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 执行步骤
 ### 1. 验证前置条件
 
 检查必要文件：

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

@@ -16,6 +16,10 @@ Restore local task workspace files from platform Issue comments that contain syn
 
 Version stamp rule: when creating or updating `task.md` frontmatter, read `.agents/rules/version-stamp.md` first and write or refresh `agent_infra_version`.
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Steps
 
 ### 1. Verify Input and Environment
@@ -90,10 +94,18 @@ Update the restored `task.md`:
 
 Append an Activity Log entry indicating the task was restored from the platform Issue.
 
+**Re-allocate short id** (the task directory is back under `active/`; alloc a new `#N`, which may differ from the pre-archival value):
+
+```bash
+node .agents/scripts/task-short-id.js alloc "$task_id"
+```
+
 ### 7. Inform User
 
 Report the restored task id, restored file count, and the active task directory.
 
+
+
 ## Completion Checklist
 
 - [ ] Fetched Issue comments from the platform

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

@@ -16,8 +16,11 @@ description: "从平台 Issue 评论还原本地任务文件"
 
 版本戳规则：创建或更新 `task.md` frontmatter 时，先读取 `.agents/rules/version-stamp.md`，并写入或刷新 `agent_infra_version`。
 
-## 执行步骤
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 执行步骤
 ### 1. 验证输入与环境
 
 检查：
@@ -90,10 +93,18 @@ date "+%Y-%m-%d %H:%M:%S%:z"
 
 追加 Activity Log，说明任务已从平台 Issue 还原。
 
+**重新分配短号**（已把任务目录写回 `active/`，需要在锁内重新 alloc；新短号可能与归档前不同）：
+
+```bash
+node .agents/scripts/task-short-id.js alloc "$task_id"
+```
+
 ### 7. 告知用户
 
 报告已恢复的 task id、恢复文件数量和 active task 目录。
 
+
+
 ## 完成检查清单
 
 - [ ] 已从平台获取 Issue 评论

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

@@ -26,6 +26,10 @@ ls -la .agents/workspace/active/{task-id}/
 tail .agents/workspace/active/{task-id}/task.md
 ```
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Steps
 
 ### 1. Verify Prerequisites

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

@@ -28,8 +28,11 @@ tail .agents/workspace/active/{task-id}/task.md
 
 状态核对完成前，禁止任何关于外部状态的断言。
 
-## 执行步骤
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 执行步骤
 ### 1. 验证前置条件
 
 要求存在：

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

@@ -36,6 +36,10 @@ tail .agents/workspace/active/{task-id}/task.md
 
 Before the state check is complete, do not make external-state assertions such as "the code is unchanged", "tests passed", or "there are no other references", including in reasoning. This gate is only a structural floor; evidence pairing and authenticity still require the report template and review discipline.
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Steps
 
 ### 1. Verify Prerequisites

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

@@ -36,8 +36,11 @@ tail .agents/workspace/active/{task-id}/task.md
 
 状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。
 
-## 执行步骤
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 执行步骤
 ### 1. 验证前置条件
 
 要求存在：

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

@@ -26,6 +26,10 @@ ls -la .agents/workspace/active/{task-id}/
 tail .agents/workspace/active/{task-id}/task.md
 ```
 
+## Task id short ref
+
+> If `{task-id}` begins with `#`, follow the "SKILL parameter resolver" section of `.agents/rules/task-short-id.md`; treat `{task-id}` as the resolved full `TASK-YYYYMMDD-HHMMSS` form for every downstream command.
+
 ## Steps
 
 ### 1. Verify Prerequisites

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

@@ -28,8 +28,11 @@ tail .agents/workspace/active/{task-id}/task.md
 
 状态核对完成前，禁止任何关于外部状态的断言。
 
-## 执行步骤
+## 任务入参短号别名
+
+> 如果 `{task-id}` 入参以 `#` 开头，先读取 `.agents/rules/task-short-id.md` 的「SKILL 入参解析」段执行解析；后续命令视 `{task-id}` 为解析后的全长 `TASK-YYYYMMDD-HHMMSS` 形式。
 
+## 执行步骤
 ### 1. 验证前置条件
 
 要求存在：

package/templates/.agents/skills/update-agent-infra/SKILL.en.md

@@ -47,6 +47,7 @@ The script outputs JSON to stdout. Parse and record the report.
 - `managed.written` / `managed.created`: updated / newly created managed files
 - `managed.removed`: deleted managed files (including old paths removed during template migrations)
 - `managed.skippedPlatform`: managed / merged entries skipped because they belong to a different platform
+- `managed.skippedTUI`: managed / merged entries skipped because they are owned by a built-in TUI that is disabled in `tuis` (customTUI command files under the same path prefix are preserved)
 - `merged.pending`: list of merged files for AI to process
   - Each item has `target` (project-relative path) and `template` (template-root-relative path)
 - `registryAdded`: newly added file registry entries

package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md

@@ -39,6 +39,7 @@ node .agents/skills/update-agent-infra/scripts/sync-templates.js
 - `managed.written` / `managed.created`：已更新/新建的 managed 文件
 - `managed.removed`：被删除的 managed 文件（包括模板迁移时移除的旧路径）
 - `managed.skippedPlatform`：因归属其他平台而被跳过的 managed / merged 条目
+- `managed.skippedTUI`：因 `tuis` 中未启用对应内建 TUI 而被跳过的 managed / merged 条目（落在同一路径前缀下的 customTUI 命令文件会被保留）
 - `merged.pending`：需要 AI 处理的 merged 文件列表
   - 每项包含 `target`（项目中的目标路径）和 `template`（模板根目录下的相对路径）
 - `registryAdded`：新增的文件注册条目

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

@@ -42,6 +42,9 @@ const DEFAULTS = {
       "disk": null
     }
   },
+  "task": {
+    "shortIdLength": 2
+  },
   "labels": {
     "in": {}
   },
@@ -88,6 +91,39 @@ const PACKAGE_NAME = '@fitlab-ai/agent-infra';
 const KNOWN_PLATFORMS = new Set(['github']);
 const KNOWN_LANGUAGES = new Set(['en', 'zh-CN']);
 
+// Single source of truth for built-in TUI ids and owned path prefixes.
+// Keep in sync with lib/builtin-tuis.ts (enforced by tests/unit/scripts/sync-templates-consts.test.ts).
+const BUILTIN_TUI_IDS = ['claude-code', 'codex', 'gemini-cli', 'opencode'];
+const BUILTIN_TUI_OWNED_PATH_PREFIXES = {
+  'claude-code': ['.claude/'],
+  'codex': ['.codex/'],
+  'gemini-cli': ['.gemini/'],
+  'opencode': ['.opencode/']
+};
+
+function resolveEnabledTUIs(value) {
+  // Missing field / null / non-array → full set (backward compat).
+  if (!Array.isArray(value)) return new Set(BUILTIN_TUI_IDS);
+  // Empty array is a meaningful user choice: no built-in TUI managed.
+  const set = new Set();
+  for (const v of value) {
+    if (typeof v === 'string' && BUILTIN_TUI_IDS.includes(v)) set.add(v);
+  }
+  return set;
+}
+
+function isPathOwnedByDisabledTUI(rel, enabledSet) {
+  const normalized = String(rel || '').replace(/\\/g, '/').replace(/^\.\//, '');
+  for (const tui of BUILTIN_TUI_IDS) {
+    if (enabledSet.has(tui)) continue;
+    for (const prefix of BUILTIN_TUI_OWNED_PATH_PREFIXES[tui]) {
+      const trimmed = prefix.replace(/\/$/, '');
+      if (normalized === trimmed || normalized.startsWith(prefix)) return true;
+    }
+  }
+  return false;
+}
+
 function norm(p) { return p.replace(/\\/g, '/'); }
 
 function normDir(p) {
@@ -654,26 +690,32 @@ function learnAndGenerateCommands(projectRoot, customSkills, tool, templateSkill
   }
 }
 
-function generateCustomCommands(projectRoot, customSkills, project, lang, report, customTUIs, templateSkillNames) {
+function generateCustomCommands(projectRoot, customSkills, project, lang, report, customTUIs, templateSkillNames, enabledTUIs) {
   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
-    );
+    if (enabledTUIs.has('claude-code')) {
+      writeIfChanged(
+        projectRoot,
+        `.claude/commands/${skill.dirName}.md`,
+        generateClaudeCommand(skill, lang),
+        report.custom.commands
+      );
+    }
+    if (enabledTUIs.has('gemini-cli')) {
+      writeIfChanged(
+        projectRoot,
+        '.gemini/commands/' + project + '/' + skill.dirName + '.toml',
+        generateGeminiCommand(skill, lang),
+        report.custom.commands
+      );
+    }
+    if (enabledTUIs.has('opencode')) {
+      writeIfChanged(
+        projectRoot,
+        `.opencode/commands/${skill.dirName}.md`,
+        generateOpenCodeCommand(skill, lang),
+        report.custom.commands
+      );
+    }
   }
 
   const tools = Array.isArray(customTUIs) ? customTUIs : [];
@@ -969,6 +1011,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
 
   const { project, org, language: lang = 'en' } = cfg;
   const platformType = cfg.platform?.type || DEFAULTS.platform.type;
+  const enabledTUIs = resolveEnabledTUIs(cfg.tuis);
   const customTUIsConfig = Array.isArray(cfg.customTUIs) ? cfg.customTUIs : [];
   const vars = { project, org };
   const templateSkillNames = listTemplateSkillNames(templateRoot);
@@ -989,7 +1032,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
       errors: [],
       conflicts: []
     },
-    managed: { written: [], created: [], unchanged: [], skippedMerged: [], skippedPlatform: [], removed: [] },
+    managed: { written: [], created: [], unchanged: [], skippedMerged: [], skippedPlatform: [], skippedTUI: [], removed: [] },
     custom: {
       detected: [],
       generated: [],
@@ -1016,10 +1059,12 @@ function syncTemplates(projectRoot, templateRootOverride) {
   const known = new Set([...managed, ...merged, ...ejected]);
   for (const e of (DEFAULTS.files.managed || [])) {
     if (isPathOwnedByOtherPlatform(e, platformType)) continue;
+    if (isPathOwnedByDisabledTUI(e, enabledTUIs)) continue;
     if (!known.has(e)) { managed.push(e); known.add(e); report.registryAdded.push({ entry: e, list: 'managed' }); }
   }
   for (const e of (DEFAULTS.files.merged || [])) {
     if (isPathOwnedByOtherPlatform(e, platformType)) continue;
+    if (isPathOwnedByDisabledTUI(e, enabledTUIs)) continue;
     if (!known.has(e)) { merged.push(e); known.add(e); report.registryAdded.push({ entry: e, list: 'merged' }); }
   }
 
@@ -1050,11 +1095,50 @@ function syncTemplates(projectRoot, templateRootOverride) {
     report.managed.removed.push(norm(path.relative(projectRoot, target)));
   }
 
+  // Cleanup files owned by disabled built-in TUIs. Iterates managed + merged
+  // only (ejected entries are explicitly user-retained, see ejected loop below).
+  //
+  // Protection rule: only skip files registered as customTUI command targets
+  // (e.g. a customTUI configured with dir=.codex/commands/ when codex is
+  // disabled). Built-in TUI custom-skill commands like
+  // .gemini/commands/<project>/<dirName>.toml are intentionally NOT protected
+  // here so that disabling gemini-cli actually frees the gemini directory —
+  // they will be regenerated only for still-enabled TUIs (see
+  // generateCustomCommands).
+  for (const entry of [...managed, ...merged]) {
+    if (!isPathOwnedByDisabledTUI(entry, enabledTUIs)) continue;
+
+    if (entry.endsWith('/')) {
+      const dir = path.join(projectRoot, entry);
+      if (!fs.existsSync(dir)) continue;
+
+      for (const filePath of walkDir(dir)) {
+        const relProj = norm(path.relative(projectRoot, filePath));
+        if (customTUICommandTargets.has(relProj)) continue;
+        fs.unlinkSync(filePath);
+        report.managed.removed.push(relProj);
+      }
+      removeEmptyDirs(dir);
+      continue;
+    }
+
+    const target = path.join(projectRoot, renderPathname(entry, project));
+    if (!fs.existsSync(target)) continue;
+    const relProj = norm(path.relative(projectRoot, target));
+    if (customTUICommandTargets.has(relProj)) continue;
+    fs.unlinkSync(target);
+    report.managed.removed.push(relProj);
+  }
+
   for (const entry of managed) {
     if (isPathOwnedByOtherPlatform(entry, platformType)) {
       report.managed.skippedPlatform.push(entry);
       continue;
     }
+    if (isPathOwnedByDisabledTUI(entry, enabledTUIs)) {
+      report.managed.skippedTUI.push(entry);
+      continue;
+    }
 
     const isDir = entry.endsWith('/');
     let entryRels;
@@ -1140,7 +1224,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
 
   const customSkills = detectCustomSkills(projectRoot, templateSkillNames);
   report.custom.detected = customSkills.map((skill) => skill.dirName);
-  generateCustomCommands(projectRoot, customSkills, project, lang, report, customTUIs, templateSkillNames);
+  generateCustomCommands(projectRoot, customSkills, project, lang, report, customTUIs, templateSkillNames, enabledTUIs);
 
   for (const entry of ejected) {
     const dstFull = path.join(projectRoot, entry);
@@ -1148,6 +1232,9 @@ function syncTemplates(projectRoot, templateRootOverride) {
       report.ejected.skipped.push(entry);
       continue;
     }
+    // Do not (re)create ejected files for disabled TUIs. Existing files are
+    // never touched by sync (handled above); this guard only blocks creation.
+    if (isPathOwnedByDisabledTUI(entry, enabledTUIs)) continue;
 
     const selected = platformSelect(langSelect(entryVariantRels(entry, allSet, platformType), lang, allSet, project), platformType, project);
     const target = norm(renderPathname(entry, project));
@@ -1168,6 +1255,10 @@ function syncTemplates(projectRoot, templateRootOverride) {
       report.managed.skippedPlatform.push(entry);
       continue;
     }
+    if (isPathOwnedByDisabledTUI(entry, enabledTUIs)) {
+      report.managed.skippedTUI.push(entry);
+      continue;
+    }
 
     if (entry.includes('*')) {
       const hits = allRels.filter(r => {

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

@@ -7,6 +7,7 @@ status: open                   # open | in-progress | review | blocked | complet
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 agent_infra_version: v0.0.0    # Current agent-infra version; refreshed by workflow commands
+short_id:                       # Allocated by create-task / import-* in active window; kept as historical value after archival
 priority:                       # Optional Issue field: Urgent | High | Medium | Low
 effort:                         # Optional Issue field: High | Medium | Low
 start_date:                     # Optional Issue field for Feature: YYYY-MM-DD

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

@@ -7,6 +7,7 @@ status: open                   # open | in-progress | review | blocked | complet
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 agent_infra_version: v0.0.0    # 当前 agent-infra 版本；由工作流命令刷新
+short_id:                       # 由 create-task / import-* 在 active 期内写入；归档后保留历史值
 priority:                       # 可选 Issue 字段：Urgent | High | Medium | Low
 effort:                         # 可选 Issue 字段：High | Medium | Low
 start_date:                     # Feature 可选 Issue 字段：YYYY-MM-DD