@fitlab-ai/agent-infra 0.6.0 → 0.6.2-alpha.1

package/README.md

@@ -666,15 +666,15 @@ Use the top-level `.agents/.airc.json` `customTUIs` array when your team uses an
 
 | Field | Required | Meaning |
 |-------|----------|---------|
-| `name` | Yes | Display name shown in reports and next-step guidance, for example `Acme TUI`. |
-| `dir` | Yes | Command directory relative to the project root, for example `.acme/commands`. The path must stay inside the project root. |
+| `name` | Yes | Display name shown in reports and next-step guidance, for example `<your-tui-name>`. |
+| `dir` | Yes | Command directory relative to the project root, for example `.<your-tui>/commands`. The path must stay inside the project root. |
 | `invoke` | Yes | User-facing command template used in next-step guidance. |
 
 Supported `invoke` placeholders:
 
 | Placeholder | Replaced with | Example |
 |-------------|---------------|---------|
-| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | The `.airc.json` `project` value. Use this for namespaced commands. | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 Non-namespaced custom TUI:
@@ -683,9 +683,9 @@ Non-namespaced custom TUI:
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -698,8 +698,8 @@ Namespaced custom TUI:
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]
@@ -777,7 +777,7 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.6.0",
+  "templateVersion": "v0.6.1",
   "templates": {
     "sources": [
       { "type": "local", "path": "~/private-templates" }
@@ -790,9 +790,9 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   },
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ],
   "files": {

package/README.zh-CN.md

@@ -642,15 +642,15 @@ args: "<task-id>"   # 可选
 
 | 字段 | 必填 | 含义 |
 |------|------|------|
-| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `Acme TUI`。 |
-| `dir` | 是 | 相对项目根目录的命令目录，例如 `.acme/commands`。路径必须位于项目根目录内。 |
+| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `<your-tui-name>`。 |
+| `dir` | 是 | 相对项目根目录的命令目录，例如 `.<your-tui>/commands`。路径必须位于项目根目录内。 |
 | `invoke` | 是 | 面向用户展示的命令模板，用于生成下一步提示。 |
 
 `invoke` 支持的占位符：
 
 | 占位符 | 替换为 | 示例 |
 |--------|--------|------|
-| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | `.airc.json` 中的 `project` 值，适用于带命名空间的命令。 | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 不带命名空间的自定义 TUI：
@@ -659,9 +659,9 @@ args: "<task-id>"   # 可选
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -674,8 +674,8 @@ args: "<task-id>"   # 可选
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]
@@ -753,7 +753,7 @@ import-issue #42                    从 GitHub Issue 导入任务
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.6.0",
+  "templateVersion": "v0.6.1",
   "templates": {
     "sources": [
       { "type": "local", "path": "~/private-templates" }
@@ -766,9 +766,9 @@ import-issue #42                    从 GitHub Issue 导入任务
   },
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ],
   "files": {

package/bin/cli.ts

@@ -97,7 +97,11 @@ switch (command) {
     break;
   }
   case 'version': {
-    console.log(`agent-infra ${VERSION}`);
+    if (process.argv[3] === '--raw') {
+      console.log(VERSION);
+    } else {
+      console.log(`agent-infra ${VERSION}`);
+    }
     break;
   }
   case 'help':

package/dist/bin/cli.js

@@ -100,7 +100,12 @@ switch (command) {
         break;
     }
     case 'version': {
-        console.log(`agent-infra ${VERSION}`);
+        if (process.argv[3] === '--raw') {
+            console.log(VERSION);
+        }
+        else {
+            console.log(`agent-infra ${VERSION}`);
+        }
         break;
     }
     case 'help':

package/dist/lib/defaults.json

@@ -5,13 +5,13 @@
   "sandbox": {
     "engine": null,
     "runtimes": [
-      "node20"
+      "node22"
     ],
     "tools": [
       "claude-code",
       "codex",
-      "opencode",
-      "gemini-cli"
+      "gemini-cli",
+      "opencode"
     ],
     "dockerfile": null,
     "vm": {
@@ -27,6 +27,7 @@
     "managed": [
       ".agents/QUICKSTART.md",
       ".agents/README.md",
+      ".agents/hooks/",
       ".agents/rules/",
       ".agents/scripts/",
       ".agents/skills/",
@@ -34,7 +35,7 @@
       ".agents/workflows/",
       ".agents/workspace/README.md",
       ".claude/commands/",
-      ".claude/hooks/",
+      ".codex/hooks.json",
       ".gemini/commands/",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",

package/dist/lib/sandbox/config.js

@@ -2,12 +2,14 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
+import pc from 'picocolors';
 import { validateSandboxEngine } from "./engine.js";
 import { hostJoin } from "./engines/wsl2-paths.js";
+import { findRuntimeEngineMismatches } from "./runtime-engines.js";
 const DEFAULTS = Object.freeze({
     engine: null,
-    runtimes: ['node20'],
-    tools: ['claude-code', 'codex', 'opencode', 'gemini-cli'],
+    runtimes: ['node22'],
+    tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
     dockerfile: null,
     vm: {
         cpu: null,
@@ -38,7 +40,7 @@ function cloneDefaults() {
         vm: { ...DEFAULTS.vm }
     };
 }
-export function loadConfig({ platformFn = platform } = {}) {
+export function loadConfig({ platformFn = platform, writeStderr = (chunk) => process.stderr.write(chunk) } = {}) {
     const repoRoot = detectRepoRoot();
     const home = homedir();
     if (!home) {
@@ -56,6 +58,24 @@ export function loadConfig({ platformFn = platform } = {}) {
     if (!project || typeof project !== 'string') {
         throw new Error('sandbox: .agents/.airc.json is missing a valid "project" field');
     }
+    const runtimes = Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
+        ? [...sandbox.runtimes]
+        : defaults.runtimes;
+    const dockerfile = typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null;
+    if (!dockerfile) {
+        let enginesNode;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8'));
+            enginesNode = typeof pkg.engines?.node === 'string' ? pkg.engines.node : undefined;
+        }
+        catch {
+            enginesNode = undefined;
+        }
+        for (const { runtimes: invalidRuntimes, enginesNode: range } of findRuntimeEngineMismatches(runtimes, enginesNode)) {
+            writeStderr(pc.yellow(`Warning: sandbox runtimes ${invalidRuntimes.map((runtime) => `"${runtime}"`).join(', ')} do not satisfy this project's package.json "engines.node" ("${range}").\n` +
+                '  Update "sandbox.runtimes" in .agents/.airc.json (e.g. "node22"), or relax "engines.node".\n'));
+        }
+    }
     return {
         repoRoot,
         configPath,
@@ -68,13 +88,11 @@ export function loadConfig({ platformFn = platform } = {}) {
         shareBase: hostJoin(home, '.agent-infra', 'share', project),
         dotfilesDir: hostJoin(home, '.agent-infra', 'dotfiles'),
         engine,
-        runtimes: Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
-            ? [...sandbox.runtimes]
-            : defaults.runtimes,
+        runtimes,
         tools: Array.isArray(sandbox.tools) && sandbox.tools.length > 0
             ? [...sandbox.tools]
             : defaults.tools,
-        dockerfile: typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null,
+        dockerfile,
         vm: {
             cpu: asPositiveNumberOrNull(sandbox.vm?.cpu) ?? defaults.vm.cpu,
             memory: asPositiveNumberOrNull(sandbox.vm?.memory) ?? defaults.vm.memory,

package/dist/lib/sandbox/runtime-engines.js

@@ -0,0 +1,27 @@
+import semver from 'semver';
+function nodeMajor(runtime) {
+    const match = /^node(\d+)$/.exec(runtime);
+    return match ? Number(match[1]) : null;
+}
+export function findRuntimeEngineMismatches(runtimes, enginesNode) {
+    if (!enginesNode) {
+        return [];
+    }
+    const range = semver.validRange(enginesNode);
+    if (!range) {
+        return [];
+    }
+    const nodeRuntimes = [];
+    for (const runtime of runtimes) {
+        const major = nodeMajor(runtime);
+        if (major === null) {
+            continue;
+        }
+        nodeRuntimes.push(runtime);
+        if (semver.intersects(`${major}.x`, range)) {
+            return [];
+        }
+    }
+    return nodeRuntimes.length > 0 ? [{ runtimes: nodeRuntimes, enginesNode }] : [];
+}
+//# sourceMappingURL=runtime-engines.js.map

package/dist/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.6.0",
+  "version": "0.6.2-alpha.1",
   "type": "module"
 }

package/lib/defaults.json

@@ -5,13 +5,13 @@
   "sandbox": {
     "engine": null,
     "runtimes": [
-      "node20"
+      "node22"
     ],
     "tools": [
       "claude-code",
       "codex",
-      "opencode",
-      "gemini-cli"
+      "gemini-cli",
+      "opencode"
     ],
     "dockerfile": null,
     "vm": {
@@ -27,6 +27,7 @@
     "managed": [
       ".agents/QUICKSTART.md",
       ".agents/README.md",
+      ".agents/hooks/",
       ".agents/rules/",
       ".agents/scripts/",
       ".agents/skills/",
@@ -34,7 +35,7 @@
       ".agents/workflows/",
       ".agents/workspace/README.md",
       ".claude/commands/",
-      ".claude/hooks/",
+      ".codex/hooks.json",
       ".gemini/commands/",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",

package/lib/sandbox/config.ts

@@ -2,13 +2,15 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
+import pc from 'picocolors';
 import { validateSandboxEngine } from './engine.ts';
 import { hostJoin } from './engines/wsl2-paths.ts';
+import { findRuntimeEngineMismatches } from './runtime-engines.ts';
 
 const DEFAULTS = Object.freeze({
   engine: null,
-  runtimes: ['node20'],
-  tools: ['claude-code', 'codex', 'opencode', 'gemini-cli'],
+  runtimes: ['node22'],
+  tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
   dockerfile: null,
   vm: {
     cpu: null,
@@ -18,6 +20,7 @@ const DEFAULTS = Object.freeze({
 });
 
 type PlatformFn = typeof platform;
+type WriteStderr = (chunk: string) => unknown;
 
 type SandboxConfigInput = {
   engine?: string | null;
@@ -82,7 +85,10 @@ function cloneDefaults(): SandboxConfigInput & { vm: SandboxVmConfig; runtimes:
   };
 }
 
-export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn } = {}): SandboxConfig {
+export function loadConfig({
+  platformFn = platform,
+  writeStderr = (chunk) => process.stderr.write(chunk)
+}: { platformFn?: PlatformFn; writeStderr?: WriteStderr } = {}): SandboxConfig {
   const repoRoot = detectRepoRoot();
   const home = homedir();
 
@@ -105,6 +111,30 @@ export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn
     throw new Error('sandbox: .agents/.airc.json is missing a valid "project" field');
   }
 
+  const runtimes = Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
+    ? [...sandbox.runtimes]
+    : defaults.runtimes;
+  const dockerfile = typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null;
+
+  if (!dockerfile) {
+    let enginesNode: string | undefined;
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8')) as {
+        engines?: { node?: unknown };
+      };
+      enginesNode = typeof pkg.engines?.node === 'string' ? pkg.engines.node : undefined;
+    } catch {
+      enginesNode = undefined;
+    }
+
+    for (const { runtimes: invalidRuntimes, enginesNode: range } of findRuntimeEngineMismatches(runtimes, enginesNode)) {
+      writeStderr(pc.yellow(
+        `Warning: sandbox runtimes ${invalidRuntimes.map((runtime) => `"${runtime}"`).join(', ')} do not satisfy this project's package.json "engines.node" ("${range}").\n` +
+        '  Update "sandbox.runtimes" in .agents/.airc.json (e.g. "node22"), or relax "engines.node".\n'
+      ));
+    }
+  }
+
   return {
     repoRoot,
     configPath,
@@ -117,13 +147,11 @@ export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn
     shareBase: hostJoin(home, '.agent-infra', 'share', project),
     dotfilesDir: hostJoin(home, '.agent-infra', 'dotfiles'),
     engine,
-    runtimes: Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
-      ? [...sandbox.runtimes]
-      : defaults.runtimes,
+    runtimes,
     tools: Array.isArray(sandbox.tools) && sandbox.tools.length > 0
       ? [...sandbox.tools]
       : defaults.tools,
-    dockerfile: typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null,
+    dockerfile,
     vm: {
       cpu: asPositiveNumberOrNull(sandbox.vm?.cpu) ?? defaults.vm.cpu,
       memory: asPositiveNumberOrNull(sandbox.vm?.memory) ?? defaults.vm.memory,

package/lib/sandbox/runtime-engines.ts

@@ -0,0 +1,39 @@
+import semver from 'semver';
+
+export type RuntimeEngineMismatch = {
+  runtimes: string[];
+  enginesNode: string;
+};
+
+function nodeMajor(runtime: string): number | null {
+  const match = /^node(\d+)$/.exec(runtime);
+  return match ? Number(match[1]) : null;
+}
+
+export function findRuntimeEngineMismatches(
+  runtimes: string[],
+  enginesNode: string | undefined
+): RuntimeEngineMismatch[] {
+  if (!enginesNode) {
+    return [];
+  }
+
+  const range = semver.validRange(enginesNode);
+  if (!range) {
+    return [];
+  }
+
+  const nodeRuntimes: string[] = [];
+  for (const runtime of runtimes) {
+    const major = nodeMajor(runtime);
+    if (major === null) {
+      continue;
+    }
+    nodeRuntimes.push(runtime);
+    if (semver.intersects(`${major}.x`, range)) {
+      return [];
+    }
+  }
+
+  return nodeRuntimes.length > 0 ? [{ runtimes: nodeRuntimes, enginesNode }] : [];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.6.0",
+  "version": "0.6.2-alpha.1",
   "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 @@
     "@clack/prompts": "1.4.0",
     "cross-spawn": "^7.0.6",
     "picocolors": "1.1.1",
+    "semver": "^7.8.1",
     "smol-toml": "^1.6.1"
   },
   "scripts": {
@@ -60,7 +61,8 @@
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^22.19.19",
-    "typescript": "~5.9"
+    "@types/node": "^25.9.1",
+    "@types/semver": "^7.7.1",
+    "typescript": "~6.0"
   }
 }

package/templates/.agents/README.en.md

@@ -199,15 +199,15 @@ Use the top-level `.agents/.airc.json` `customTUIs` array when your team uses an
 
 | Field | Required | Meaning |
 |-------|----------|---------|
-| `name` | Yes | Display name shown in reports and next-step guidance, for example `Acme TUI`. |
-| `dir` | Yes | Command directory relative to the project root, for example `.acme/commands`. The path must stay inside the project root. |
+| `name` | Yes | Display name shown in reports and next-step guidance, for example `<your-tui-name>`. |
+| `dir` | Yes | Command directory relative to the project root, for example `.<your-tui>/commands`. The path must stay inside the project root. |
 | `invoke` | Yes | User-facing command template used in next-step guidance. |
 
 Supported `invoke` placeholders:
 
 | Placeholder | Replaced with | Example |
 |-------------|---------------|---------|
-| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | The `.airc.json` `project` value. Use this for namespaced commands. | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 Non-namespaced custom TUI:
@@ -216,9 +216,9 @@ Non-namespaced custom TUI:
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -231,8 +231,8 @@ Namespaced custom TUI:
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]

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

@@ -199,15 +199,15 @@ args: "<task-id>"   # 可选
 
 | 字段 | 必填 | 含义 |
 |------|------|------|
-| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `Acme TUI`。 |
-| `dir` | 是 | 相对项目根目录的命令目录，例如 `.acme/commands`。路径必须位于项目根目录内。 |
+| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `<your-tui-name>`。 |
+| `dir` | 是 | 相对项目根目录的命令目录，例如 `.<your-tui>/commands`。路径必须位于项目根目录内。 |
 | `invoke` | 是 | 面向用户展示的命令模板，用于生成下一步提示。 |
 
 `invoke` 支持的占位符：
 
 | 占位符 | 替换为 | 示例 |
 |--------|--------|------|
-| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | `.airc.json` 中的 `project` 值，适用于带命名空间的命令。 | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 不带命名空间的自定义 TUI：
@@ -216,9 +216,9 @@ args: "<task-id>"   # 可选
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -231,8 +231,8 @@ args: "<task-id>"   # 可选
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]

package/templates/{.claude → .agents}/hooks/check-version-format.sh

@@ -10,7 +10,7 @@ hook_command=$(
       try {
         const payload = JSON.parse(Buffer.concat(chunks).toString());
         process.stdout.write(payload.tool_input && payload.tool_input.command || "");
-      } catch (error) {
+      } catch {
         process.stdout.write("");
       }
     });
@@ -30,14 +30,14 @@ repo_root=$(
 )
 
 if sh "$repo_root/.git-hooks/check-version-format.sh"; then
-  echo "Claude hook: version check passed."
+  echo "AI hook: version check passed."
   exit 0
 else
   status=$?
 fi
 
 if [ "$status" -eq 1 ]; then
-  echo "Claude hook: blocking git commit (version format error)."
+  echo "AI hook: blocking git commit (version format error)." >&2
   exit 2
 fi
 

package/templates/.agents/rules/create-issue.github.en.md

@@ -149,6 +149,12 @@ gh api "repos/$upstream_repo/issues/{issue-number}" -X PATCH \
 
 Failure is non-blocking.
 
+### 6.5 Set Issue Fields (Optional)
+
+If `has_push=true`, read `.agents/rules/issue-fields.md` and follow Flow A to write any applicable non-empty `priority`, `effort`, `start_date`, and `target_date` values from `task.md`.
+
+Field write failures are non-blocking.
+
 ### 7. Write Back task.md
 
 Update task.md:

package/templates/.agents/rules/create-issue.github.zh-CN.md

@@ -149,6 +149,12 @@ gh api "repos/$upstream_repo/issues/{issue-number}" -X PATCH \
 
 设置失败不阻断流程。
 
+### 6.5 设置 Issue 字段（可选）
+
+如果 `has_push=true`，读取 `.agents/rules/issue-fields.md`，按流程 A 写入 `task.md` 中适用且非空的 `priority`、`effort`、`start_date` 和 `target_date`。
+
+字段写入失败不阻断流程。
+
 ### 7. 回写 task.md
 
 更新 task.md：