helloagents 3.0.30 → 3.0.31

package/scripts/cli-host-detect.mjs

@@ -7,7 +7,6 @@ import {
   CODEX_PLUGIN_NAME,
 } from './cli-codex.mjs'
 import { getStableRuntimeRoot } from './cli-runtime-root.mjs'
-import { FULL_CARRIER_PROFILE_MARKER } from './cli-utils.mjs'
 import { safeJson, safeRead } from './cli-utils.mjs'
 
 const HOST_ALIASES = new Map([
@@ -19,8 +18,6 @@ const HOST_ALIASES = new Map([
   ['gemini-cli', 'gemini'],
   ['codex', 'codex'],
   ['codex-cli', 'codex'],
-  ['deepseek', 'deepseek'],
-  ['deepseek-tui', 'deepseek'],
 ])
 
 function hasHelloagentsMarker(filePath) {
@@ -31,10 +28,6 @@ function hasHelloagentsSettings(filePath) {
   return JSON.stringify(safeJson(filePath) || {}).includes('helloagents')
 }
 
-function hasFullCarrierProfile(filePath) {
-  return (safeRead(filePath) || '').includes(FULL_CARRIER_PROFILE_MARKER)
-}
-
 function normalizePath(value = '') {
   return String(value || '').replace(/\\/g, '/').toLowerCase()
 }
@@ -97,26 +90,6 @@ function detectCodexMode(home) {
   return ''
 }
 
-function detectDeepseekMode(home) {
-  const deepseekDir = join(home, '.deepseek')
-  const carrierPath = join(deepseekDir, 'AGENTS.md')
-  const runtimeRoot = normalizePath(getStableRuntimeRoot(home))
-  const homeLinkTarget = safeRealTarget(join(deepseekDir, 'helloagents'))
-  if (
-    (hasHelloagentsMarker(carrierPath) || (existsSync(join(deepseekDir, 'helloagents')) && homeLinkTarget === runtimeRoot))
-    && hasFullCarrierProfile(carrierPath)
-  ) {
-    return 'global'
-  }
-  if (
-    (existsSync(join(deepseekDir, 'helloagents')) && homeLinkTarget === runtimeRoot)
-    || hasHelloagentsMarker(carrierPath)
-  ) {
-    return 'standby'
-  }
-  return ''
-}
-
 export function normalizeHost(value = '') {
   return HOST_ALIASES.get(String(value || '').toLowerCase()) || ''
 }
@@ -125,7 +98,6 @@ export function getHostLabel(host) {
   if (host === 'claude') return 'Claude Code'
   if (host === 'gemini') return 'Gemini CLI'
   if (host === 'codex') return 'Codex CLI'
-  if (host === 'deepseek') return 'DeepSeek TUI'
   return 'All CLIs'
 }
 
@@ -133,6 +105,5 @@ export function detectHostMode(host, runtime) {
   if (host === 'claude') return detectClaudeMode(runtime.home)
   if (host === 'gemini') return detectGeminiMode(runtime.home)
   if (host === 'codex') return detectCodexMode(runtime.home)
-  if (host === 'deepseek') return detectDeepseekMode(runtime.home)
   return ''
 }

package/scripts/cli-hosts.mjs

@@ -12,7 +12,6 @@ import {
   loadHooksWithCliEntry,
 } from './cli-utils.mjs';
 import { buildRuntimeCarrier, readCarrierSettings } from './cli-runtime-carrier.mjs';
-import { installDeepseekGlobal, installDeepseekStandby, uninstallDeepseekGlobal, uninstallDeepseekStandby } from './cli-deepseek.mjs'
 
 export function installClaudeStandby(home, pkgRoot) {
   const claudeDir = join(home, '.claude');
@@ -82,10 +81,3 @@ export function uninstallGeminiStandby(home) {
 
   return true;
 }
-
-export {
-  installDeepseekGlobal,
-  installDeepseekStandby,
-  uninstallDeepseekGlobal,
-  uninstallDeepseekStandby,
-}

package/scripts/cli-lifecycle-hosts.mjs

@@ -2,12 +2,8 @@ import { spawnSync } from 'node:child_process'
 
 import {
   installClaudeStandby,
-  installDeepseekGlobal,
-  installDeepseekStandby,
   installGeminiStandby,
   uninstallClaudeStandby,
-  uninstallDeepseekGlobal,
-  uninstallDeepseekStandby,
   uninstallGeminiStandby,
 } from './cli-hosts.mjs'
 import {
@@ -100,10 +96,6 @@ function installHostStandby(runtime, host) {
     installGeminiStandby(runtime.home, runtime.pkgRoot)
     return {}
   }
-  if (host === 'deepseek') {
-    installDeepseekStandby(runtime.home, runtime.pkgRoot)
-    return {}
-  }
   if (!installCodexStandby(runtime.home, runtime.pkgRoot)) return { skipped: true }
   cleanupCodexGlobalResidueForStandby(runtime.home)
   return {}
@@ -130,10 +122,6 @@ function installHostGlobal(runtime, host) {
       'Gemini CLI extension auto-install failed. Run manually: gemini extensions install https://github.com/hellowind777/helloagents',
     )
   }
-  if (host === 'deepseek') {
-    installDeepseekGlobal(runtime.home, runtime.pkgRoot)
-    return {}
-  }
   uninstallCodexStandby(runtime.home)
   return installCodexGlobal(runtime.home, runtime.pkgRoot) ? {} : { skipped: true }
 }
@@ -141,7 +129,6 @@ function installHostGlobal(runtime, host) {
 function cleanupHostStandby(runtime, host) {
   if (host === 'claude') return { skipped: !uninstallClaudeStandby(runtime.home) }
   if (host === 'gemini') return { skipped: !uninstallGeminiStandby(runtime.home) }
-  if (host === 'deepseek') return { skipped: !uninstallDeepseekStandby(runtime.home) }
   const standbyCleaned = uninstallCodexStandby(runtime.home)
   const globalResidueCleaned = uninstallCodexGlobal(runtime.home)
   return { skipped: !(standbyCleaned || globalResidueCleaned) }
@@ -168,7 +155,6 @@ function cleanupHostGlobal(runtime, host) {
       'Gemini CLI extension auto-remove failed. Run manually: gemini extensions uninstall helloagents',
     )
   }
-  if (host === 'deepseek') return { skipped: !uninstallDeepseekGlobal(runtime.home) }
   return { skipped: !uninstallCodexGlobal(runtime.home) }
 }
 
@@ -194,18 +180,12 @@ function installStandby(runtime) {
     console.log(runtime.msg('  - Codex CLI 未检测到，跳过', '  - Codex CLI not detected, skipped'))
     results.codex = { skipped: true }
   }
-  if (installDeepseekStandby(runtime.home, runtime.pkgRoot)) {
-    runtime.ok(runtime.msg('DeepSeek TUI 已配置（standby 模式）', 'DeepSeek TUI configured (standby mode)'))
-    results.deepseek = {}
-  } else {
-    results.deepseek = { skipped: true }
-  }
   return results
 }
 
 function installGlobal(runtime) {
   const results = {}
-  for (const host of ['claude', 'gemini', 'codex', 'deepseek']) {
+  for (const host of ['claude', 'gemini', 'codex']) {
     const result = installHostGlobal(runtime, host)
     reportHostAction(runtime, 'install', host, 'global', result)
     results[host] = result
@@ -223,7 +203,6 @@ export function uninstallAllHosts(runtime) {
   cleanupHostGlobal(runtime, 'gemini')
   uninstallCodexStandby(runtime.home)
   uninstallCodexGlobal(runtime.home)
-  uninstallDeepseekStandby(runtime.home)
 }
 
 export function runHostLifecycle(runtime, action, host, mode) {

package/scripts/cli-lifecycle.mjs

@@ -10,7 +10,7 @@ import {
 import { installAllHosts, runHostLifecycle, uninstallAllHosts } from './cli-lifecycle-hosts.mjs'
 import { ensureDir, safeJson, safeWrite } from './cli-utils.mjs'
 
-export const HOSTS = ['claude', 'gemini', 'codex', 'deepseek']
+export const HOSTS = ['claude', 'gemini', 'codex']
 
 const runtime = {
   home: '',
@@ -28,14 +28,28 @@ export function initCliLifecycle(options) {
   Object.assign(runtime, options)
 }
 
+function sanitizeSettings(settings = {}) {
+  const next = settings && typeof settings === 'object' ? { ...settings } : {}
+  const tracked = next.host_install_modes
+  if (!tracked || typeof tracked !== 'object' || Array.isArray(tracked)) {
+    next.host_install_modes = {}
+    return next
+  }
+  next.host_install_modes = Object.fromEntries(
+    Object.entries(tracked).filter(([host, mode]) => HOSTS.includes(host) && typeof mode === 'string' && mode),
+  )
+  return next
+}
+
 export function readSettings(shouldEnsure = false) {
   if (shouldEnsure) ensureConfig(runtime.helloagentsHome, runtime.configFile, safeJson, ensureDir)
-  return safeJson(runtime.configFile) || {}
+  return sanitizeSettings(safeJson(runtime.configFile) || {})
 }
 
 function writeSettings(settings) {
+  const sanitized = sanitizeSettings(settings)
   ensureDir(runtime.helloagentsHome)
-  writeFileSync(runtime.configFile, JSON.stringify(settings, null, 2), 'utf-8')
+  writeFileSync(runtime.configFile, JSON.stringify(sanitized, null, 2), 'utf-8')
 }
 
 function hasTrackedHostModes(settings) {

package/scripts/cli-messages.mjs

@@ -19,18 +19,6 @@ function codexGlobalStatus({ home, msg }) {
     : msg('安装 Codex CLI 后重新运行 npm install -g helloagents', 'Install Codex CLI then re-run npm install -g helloagents')
 }
 
-function deepseekStandbyStatus({ home, msg }) {
-  return existsSync(join(home, '.deepseek'))
-    ? msg('已自动配置（~/.deepseek/AGENTS.md）', 'Auto-configured (~/.deepseek/AGENTS.md)')
-    : msg('安装 DeepSeek TUI 后重新运行 npm install -g helloagents', 'Install DeepSeek TUI then re-run npm install -g helloagents')
-}
-
-function deepseekGlobalStatus({ home, msg }) {
-  return existsSync(join(home, '.deepseek'))
-    ? msg('已自动切到受管全局载体（~/.deepseek/AGENTS.md）', 'Managed global carrier applied (~/.deepseek/AGENTS.md)')
-    : msg('安装 DeepSeek TUI 后重新运行 npm install -g helloagents', 'Install DeepSeek TUI then re-run npm install -g helloagents')
-}
-
 function pluginCommands() {
   return [
     '    Claude Code:  /plugin marketplace add hellowind777/helloagents',
@@ -61,24 +49,24 @@ function renderInstallMessage(context, mode, state) {
   if (mode === 'global') {
     if (install) {
       return msg(
-        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI: 已自动尝试宿主原生插件/扩展安装\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n    DeepSeek TUI: ${deepseekGlobalStatus(context)}\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands()}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
-        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI: native plugin/extension install attempted automatically\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n    DeepSeek TUI: ${deepseekGlobalStatus(context)}\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands()}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
+        `\n  ✅ HelloAGENTS 已安装（global 模式）！\n\n    Claude Code / Gemini CLI: 已自动尝试宿主原生插件/扩展安装\n    Codex:        ${codexGlobalStatus(context)}（~/.agents/plugins/marketplace.json + ~/plugins/helloagents）\n\n  ${restartHint(msg)}\n\n  若宿主命令不可用，请手动执行：\n${pluginCommands()}\n\n  切换模式：\n    helloagents --standby   标准模式（默认，非插件安装）`,
+        `\n  ✅ HelloAGENTS installed (global mode)!\n\n    Claude Code / Gemini CLI: native plugin/extension install attempted automatically\n    Codex:        ${codexGlobalStatus(context)} (~/.agents/plugins/marketplace.json + ~/plugins/helloagents)\n\n  ${restartHint(msg)}\n\n  If a host command is unavailable, run manually:\n${pluginCommands()}\n\n  Switch modes:\n    helloagents --standby   Standby mode (default, non-plugin install)`,
       )
     }
     return msg(
       refresh
-        ? `  global 模式已刷新。\n  Claude Code / Gemini 已自动尝试刷新宿主插件/扩展；Codex 原生本地插件已重装并同步最新文件；DeepSeek TUI 受管全局载体已同步。\n  ${restartHint(msg)}`
-        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini 已自动尝试安装宿主插件/扩展；Codex 已自动安装原生本地插件；DeepSeek TUI 已切到受管全局载体。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands()}`,
+        ? `  global 模式已刷新。\n  Claude Code / Gemini 已自动尝试刷新宿主插件/扩展；Codex 原生本地插件已重装并同步最新文件。\n  ${restartHint(msg)}`
+        : `  所有项目将自动启用完整 HelloAGENTS 规则。\n  Claude Code / Gemini 已自动尝试安装宿主插件/扩展；Codex 已自动安装原生本地插件。\n  ${restartHint(msg)}\n\n若宿主命令不可用，请手动执行：\n${pluginCommands()}`,
       refresh
-        ? `  Global mode refreshed.\n  Claude Code / Gemini native plugin/extension refresh was attempted automatically; Codex native local-plugin files were reinstalled and synced; the managed DeepSeek TUI global carrier was refreshed.\n  ${restartHint(msg)}`
-        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini native plugin/extension install was attempted automatically; Codex now uses the native local-plugin path automatically; DeepSeek TUI now uses the managed global carrier.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands()}`,
+        ? `  Global mode refreshed.\n  Claude Code / Gemini native plugin/extension refresh was attempted automatically; Codex native local-plugin files were reinstalled and synced.\n  ${restartHint(msg)}`
+        : `  All projects will use full HelloAGENTS rules.\n  Claude Code / Gemini native plugin/extension install was attempted automatically; Codex now uses the native local-plugin path automatically.\n  ${restartHint(msg)}\n\nIf a host command is unavailable, run manually:\n${pluginCommands()}`,
     )
   }
 
   if (install) {
     return msg(
-      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n    DeepSeek TUI: ${deepseekStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 或 ~init 仅创建/同步知识库；用 ~global 初始化项目级全局模式；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件；DeepSeek 使用受管 AGENTS 载体）`,
-      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n    DeepSeek TUI: ${deepseekStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki or ~init to create or sync the KB only; use ~global to initialize project-level global mode; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex; DeepSeek uses a managed AGENTS carrier)`,
+      `\n  ✅ HelloAGENTS 已安装（standby 模式）！\n\n    Claude Code:  已自动配置（~/.claude/CLAUDE.md + hooks）\n    Gemini CLI:   已自动配置（~/.gemini/GEMINI.md）\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  standby 模式下，hello-* 技能不会自动触发。\n  在项目中使用 ~wiki 或 ~init 仅创建/同步知识库；用 ~global 初始化项目级全局模式；也可用 ~command 按需调用。\n\n  切换模式：\n    helloagents --global    项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）`,
+      `\n  ✅ HelloAGENTS installed (standby mode)!\n\n    Claude Code:  Auto-configured (~/.claude/CLAUDE.md + hooks)\n    Gemini CLI:   Auto-configured (~/.gemini/GEMINI.md)\n    Codex:        ${codexStandbyStatus(context)}\n\n  ${restartHint(msg)}\n\n  In standby mode, hello-* skills won't auto-trigger.\n  Use ~wiki or ~init to create or sync the KB only; use ~global to initialize project-level global mode; ~command stays available on demand.\n\n  Switch modes:\n    helloagents --global    Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)`,
     )
   }
 
@@ -102,17 +90,17 @@ HelloAGENTS v${pkgVersion} — The orchestration kernel for AI CLIs
   helloagents-js             ${msg('（受管宿主配置的跨平台稳定入口）', '(cross-platform stable entrypoint for managed host configs)')}
 
 ${msg('模式切换', 'Mode switching')}:
-  helloagents --global     ${msg('项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件；DeepSeek 使用受管 AGENTS 载体）', 'Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex; DeepSeek uses a managed AGENTS carrier)')}
+  helloagents --global     ${msg('项目级全局模式（自动尝试 Claude/Gemini 插件或扩展；Codex 自动装原生本地插件）', 'Project-level global mode (auto-attempts Claude/Gemini plugins or extensions; native local plugin auto-install for Codex)')}
   helloagents --standby    ${msg('标准模式（非插件安装，hello-* 不自动触发，默认）', "Standby mode (non-plugin install, hello-* won't auto-trigger, default)")}
 
 ${msg('单 CLI 管理', 'Scoped CLI management')}:
   helloagents install codex --standby
-  helloagents install deepseek --standby
+  helloagents install gemini --standby
   helloagents install --all --global
   helloagents update codex
   helloagents cleanup claude --global
   helloagents uninstall gemini
-  ${msg('支持: claude | gemini | codex | deepseek | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | codex | deepseek | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
+  ${msg('支持: claude | gemini | codex | --all；省略模式时优先沿用该 CLI 已记录/已检测的模式，否则回退 standby', 'Hosts: claude | gemini | codex | --all; omit mode to reuse the tracked/detected mode for that CLI, then fall back to standby')}
 
 ${msg('分支切换', 'Branch switching')}:
   helloagents switch-branch beta
@@ -123,7 +111,7 @@ ${msg('分支切换', 'Branch switching')}:
 ${msg('诊断', 'Diagnostics')}:
   helloagents doctor
   helloagents doctor codex --json
-  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、DeepSeek 原生 doctor 摘要、受管 model_instructions_file 指向、Codex hook trust 本机状态与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, DeepSeek native doctor summaries, managed model_instructions_file targeting, machine-local Codex hook trust state, and version drift')}
+  ${msg('检查 carrier、链接、hooks、配置注入、Codex 插件安装、受管 model_instructions_file 指向、Codex hook trust 本机状态与版本漂移', 'Checks carriers, links, hooks, config injections, Codex plugin installation, managed model_instructions_file targeting, machine-local Codex hook trust state, and version drift')}
 
 ${msg('Codex /goal', 'Codex /goal')}:
   helloagents codex goals status

package/scripts/guard.mjs

@@ -133,7 +133,7 @@ function buildPostWriteWarnings(data) {
   const filePath = data.tool_input?.file_path || ''
   return [
     ...(detectIdeaBoundaryContext(data)?.zeroSideEffect
-      ? ['~idea 本轮要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
+      ? ['~idea 当前任务要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
       : []),
     ...scanUnrequestedFiles(filePath, data.tool_name),
     ...(content ? [...scanForSecrets(content), ...scanDangerousPackages(content, filePath)] : []),

package/scripts/notify-context.mjs

@@ -34,7 +34,7 @@ function buildReadRootBlock(readRoot) {
     turnStateCommand: 'helloagents-turn-state write --kind complete --role main',
     turnStateUsage: '仅在运行时需要识别完成、等待或阻塞时调用；普通问答不调用',
   };
-  return `## 本轮 HelloAGENTS 读取根目录\n\`\`\`json\n${JSON.stringify(block, null, 2)}\n\`\`\``;
+  return `## 当前对话 HelloAGENTS 读取根目录\n\`\`\`json\n${JSON.stringify(block, null, 2)}\n\`\`\``;
 }
 
 export function resolveCanonicalCommandSkill(skillName) {

package/scripts/notify-events.mjs

@@ -11,7 +11,6 @@ export function shouldIgnoreFormattedSubagent(lastMsg, outputFormatEnabled) {
 export function resolveNotifyHost(argv = []) {
   const args = Array.from(argv, (value) => String(value || ''));
   const command = args[2] || args[0] || '';
-  if (args.includes('--deepseek')) return 'deepseek';
   if (args.includes('--gemini')) return 'gemini';
   if (args.includes('--codex') || command === 'codex-notify') return 'codex';
   return 'claude';

package/scripts/notify-source.mjs

@@ -6,7 +6,6 @@ const HOST_LABELS = {
   codex: 'Codex',
   claude: 'Claude Code',
   gemini: 'Gemini',
-  deepseek: 'DeepSeek TUI',
 }
 
 function normalizePath(filePath = '') {

package/scripts/plan-contract.mjs

@@ -5,7 +5,7 @@ import { resolveProjectPlanDir } from './project-storage.mjs'
 
 export const PLAN_CONTRACT_FILE_NAME = 'contract.json'
 const VALID_VERIFY_MODES = new Set(['test-first', 'review-first'])
-const VALID_ADVISOR_SOURCES = new Set(['claude', 'codex', 'gemini', 'deepseek'])
+const VALID_ADVISOR_SOURCES = new Set(['claude', 'codex', 'gemini'])
 
 function normalizeStringArray(values) {
   if (!Array.isArray(values)) return []

package/scripts/runtime-scope.mjs

@@ -146,7 +146,7 @@ export function getProjectRoot(cwd) {
 
 function getCarrierPathForRoot(root, host = '') {
   if (!root) return ''
-  if (host === 'codex' || host === 'deepseek') return join(root, 'AGENTS.md')
+  if (host === 'codex') return join(root, 'AGENTS.md')
   if (host === 'gemini') return join(root, '.gemini', 'GEMINI.md')
   return join(root, 'CLAUDE.md')
 }

package/scripts/turn-stop-gate.mjs

@@ -39,7 +39,7 @@ function buildBlockReason(routeContext, detail, cwd) {
   const commandLabel = `~${routeContext.skillName}`
   const workflowHint = buildWorkflowHint(cwd)
   return [
-    `[HelloAGENTS Runtime] 显式 ${commandLabel} 本轮不应直接停下。`,
+    `[HelloAGENTS Runtime] 显式 ${commandLabel} 当前对话不应直接停下。`,
     detail,
     workflowHint,
     '若无真实阻塞，请继续沿当前路径执行。',
@@ -74,7 +74,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (!firstNonEmptyLine || !/^[💡⚡🔵✅❓⚠️❌]【HelloAGENTS】- /.test(firstNonEmptyLine)) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息使用了 HelloAGENTS 外层格式，但首个非空行不是规范标题行。',
+      '最终回复使用了 HelloAGENTS 外层格式，但首个非空行不是规范标题行。',
       cwd,
     )
   }
@@ -82,7 +82,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (countMatches(message, /[💡⚡🔵✅❓⚠️❌]【HelloAGENTS】-/g) > 1) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息重复输出了 HelloAGENTS 标题；请把所有内容合并到同一个外层块内。',
+      '最终回复重复输出了 HelloAGENTS 标题；请把所有内容合并到同一个外层块内。',
       cwd,
     )
   }
@@ -90,7 +90,7 @@ function validateFormattedCloseoutMessage(routeContext, payload, cwd) {
   if (countMatches(message, /^🔄 下一步:/gm) > 1) {
     return buildBlockReason(
       routeContext,
-      '最终收尾消息重复输出了 `🔄 下一步`；请只保留一个真实下一步。',
+      '最终回复重复输出了 `🔄 下一步`；请只保留一个真实下一步。',
       cwd,
     )
   }
@@ -140,7 +140,7 @@ function validateTurnState(routeContext, turnState, cwd, payload = {}) {
       cwd,
     )
   }
-  return buildBlockReason(routeContext, `当前 turn-state 为 \`${turnState.kind}\`，不能作为本轮结束状态。`, cwd)
+  return buildBlockReason(routeContext, `当前 turn-state 为 \`${turnState.kind}\`，不能作为当前对话结束状态。`, cwd)
 }
 
 export function evaluateTurnStopGate(payload = {}) {

package/skills/commands/auto/SKILL.md

@@ -15,7 +15,7 @@ Trigger: ~auto <任务描述>
 - `T3` 高风险或不可逆操作默认不直接进入 `~build`；优先先走 `~plan` 或 `~prd`，纯审查/纯验证请求才可先进入 `~verify`
 - 主路径一旦确定，立即读取对应 command skill，并在阶段完成后继续执行后续阶段，避免同一任务重复探索或重复等待
 - 选路不替代授权；涉及外部副作用或高风险不可逆操作时，仍遵守 HelloAGENTS 阻塞判定与确认规则
-- 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若本轮运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
+- 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若当前运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
 - 优先消费当前上下文中已注入的 ROUTE / TIER、当前工作流约束与项目状态；不要在 `~auto` 内另建一套关键词路由表
 
 ## 流程
@@ -33,7 +33,7 @@ Trigger: ~auto <任务描述>
 ### 1. 选路
 
 - 先按当前上下文里已注入的 ROUTE / TIER 语义约束判断，不依赖关键词命中做机械分流
-- 若本轮没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
+- 若当前上下文没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
 - 选路优先级：
   - 纯探索 / 点子 / 方向比较 → `~idea`
   - 明确要求验证 / 审查 / 跑检查 → `~verify`

package/skills/commands/build/SKILL.md

@@ -20,15 +20,15 @@ Trigger: ~build [description]
 
 ### 1. 恢复与定位
 
-- 优先按当前已加载的 HelloAGENTS 规则恢复当前任务，并遵循“.helloagents/ 文件读取优先级”；若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩，或本轮运行在 Codex active goal 下，先读取 `state_path`，再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务
+- 优先按当前已加载的 HelloAGENTS 规则恢复当前任务，并遵循“.helloagents/ 文件读取优先级”；若当前消息明确要继续上次任务、会话刚经历恢复 / 压缩，或当前运行在 Codex active goal 下，先读取 `state_path`，再用当前用户消息、活跃方案包 / PRD 与代码事实确认当前任务
 - 若存在最近的活跃方案包，读取对应的：
   - `requirements.md`
   - `plan.md`
   - `tasks.md`
   - `contract.json`
-  - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本轮实现约束，不要只按任务标题猜测范围
+  - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本次实现约束，不要只按任务标题猜测范围
   - `contract.json` 存在时，优先按其中的 `verifyMode`、`reviewerFocus`、`testerFocus` 理解后续验证边界
-- 若本轮运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包
+- 若当前运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包
 - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它；只有推荐仍为 `~build`，或用户明确提出新增实现范围时，才继续 `~build`
 - 其余项目知识库与相关代码文件，按 HelloAGENTS 项目上下文要求读取
 - 若任务涉及 UI，按以下优先级读取并遵循：当前活跃 `plan.md` / PRD 中的 UI 决策 > 逻辑 `.helloagents/DESIGN.md`（实际路径按当前项目存储模式解析） > 已读取的 `hello-ui` 规则；同时所有 UI 任务都必须满足 UI 质量基线

package/skills/commands/global/SKILL.md

@@ -24,7 +24,7 @@ Trigger: ~global
    - `.codex/skills/helloagents` symlink → `{插件根目录}/`
    这些链接用于项目级规则定位 HelloAGENTS 的 `skills/`、`templates/` 和 `scripts/`；宿主若支持递归发现 `SKILL.md`，也可直接识别包内 skills。
 4. 读取 `{插件根目录}` 中的全量规则模板，在受管内容第一行写入 `<!-- HELLOAGENTS_PROFILE: full -->`，再用 `<!-- HELLOAGENTS_START -->` / `<!-- HELLOAGENTS_END -->` 标记包裹后写入：
-   - `AGENTS.md`（项目根目录，Codex 与 DeepSeek TUI 读取）
+   - `AGENTS.md`（项目根目录，Codex 读取）
    - `CLAUDE.md`（项目根目录，Claude Code 读取）
    - `.gemini/GEMINI.md`（Gemini CLI 读取，需先创建 .gemini/ 目录）
    注意：如果文件已存在且包含标记，替换标记内的内容；如果文件已存在但无标记，追加到末尾；如果文件不存在，创建新文件

package/skills/commands/help/SKILL.md

@@ -44,14 +44,14 @@ Trigger: ~help
 如果当前 CLI 存在工作区限制导致家目录不可读，则明确说明“无法直接读取配置文件，以下按已注入设置或默认值展示”，不要改用无关工具或伪造已读取结果。
 | 配置项 | 默认值 | 作用 | 适用 CLI |
 |--------|-------|------|---------|
-| output_language | "" | 空=跟随用户语言/填写则指定（如 zh-CN、en） | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| output_format | true | true=主代理最终收尾必须使用 HelloAGENTS 格式，流式/中间输出及子代理输出保持自然；false=自然输出 | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| notify_level | 0 | 0=关闭/1=桌面通知/2=声音/3=两者 | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| ralph_loop_enabled | true | 自动验证循环（显式 ~verify / ~loop 或收尾要求时触发 lint/test/build） | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| guard_enabled | true | 阻断危险命令与写入后的安全扫描 | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| kb_create_mode | 1 | 0=关闭/1=知识库已存在时自动同步/2=编码任务在知识库已存在或全局模式下自动创建或同步 | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| project_store_mode | "local" | "local"=知识库/方案包保留在项目本地 `.helloagents/`；"repo-shared"=本地 `.helloagents/` 仅保留项目本地状态/运行态，知识库与方案包改写到 `~/.helloagents/projects/<repo-key>/` | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| auto_commit_enabled | true | true=验证完成且有变更时自动执行本地提交；false=跳过自动提交，仍可手动用 `~commit` | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| commit_attribution | "" | 空=不添加/填写内容则添加到 commit message | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| install_mode | "standby" | 当前默认安装模式 | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
-| host_install_modes | {} | 单 CLI 模式记录，优先于 install_mode | Claude Code + Gemini CLI + Codex CLI + DeepSeek TUI |
+| output_language | "" | 空=跟随用户语言/填写则指定（如 zh-CN、en） | Claude Code + Gemini CLI + Codex CLI |
+| output_format | true | true=主代理最终回复必须使用 HelloAGENTS 格式，流式/中间输出及子代理输出保持自然；false=自然输出 | Claude Code + Gemini CLI + Codex CLI |
+| notify_level | 0 | 0=关闭/1=桌面通知/2=声音/3=两者 | Claude Code + Gemini CLI + Codex CLI |
+| ralph_loop_enabled | true | 自动验证循环（显式 ~verify / ~loop 或收尾要求时触发 lint/test/build） | Claude Code + Gemini CLI + Codex CLI |
+| guard_enabled | true | 阻断危险命令与写入后的安全扫描 | Claude Code + Gemini CLI + Codex CLI |
+| kb_create_mode | 1 | 0=关闭/1=知识库已存在时自动同步/2=编码任务在知识库已存在或全局模式下自动创建或同步 | Claude Code + Gemini CLI + Codex CLI |
+| project_store_mode | "local" | "local"=知识库/方案包保留在项目本地 `.helloagents/`；"repo-shared"=本地 `.helloagents/` 仅保留项目本地状态/运行态，知识库与方案包改写到 `~/.helloagents/projects/<repo-key>/` | Claude Code + Gemini CLI + Codex CLI |
+| auto_commit_enabled | true | true=验证完成且有变更时自动执行本地提交；false=跳过自动提交，仍可手动用 `~commit` | Claude Code + Gemini CLI + Codex CLI |
+| commit_attribution | "" | 空=不添加/填写内容则添加到 commit message | Claude Code + Gemini CLI + Codex CLI |
+| install_mode | "standby" | 当前默认安装模式 | Claude Code + Gemini CLI + Codex CLI |
+| host_install_modes | {} | 单 CLI 模式记录，优先于 install_mode | Claude Code + Gemini CLI + Codex CLI |

package/skills/commands/loop/SKILL.md

@@ -37,7 +37,7 @@ iteration	commit	metric	delta	guard	status	description
 
 `~loop` 的八阶段循环是统一执行流程（ROUTE/TIER→SPEC→PLAN→BUILD→VERIFY→CONSOLIDATE）在迭代优化场景下的特化形式。每轮迭代的“修改”阶段遵循已标记的 hello-* 质量技能规范，“验证”阶段遵循 hello-verify 的验证规范。
 执行 `~loop` 时，涉及公共阶段边界、阻塞判定与收尾要求的部分，仍按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充 loop 场景的迭代顺序与回滚规则。
-若本轮运行在 Codex `/goal` 下，`/goal` 只作为外层长程续跑与预算控制；`~loop` 仍负责指标、守卫、实验提交、keep/revert、results log、`state_path` 与收尾验证，不把 `/goal` 当成循环逻辑本身。
+若当前运行在 Codex `/goal` 下，`/goal` 只作为外层长程续跑与预算控制；`~loop` 仍负责指标、守卫、实验提交、keep/revert、results log、`state_path` 与收尾验证，不把 `/goal` 当成循环逻辑本身。
 
 除非达到迭代上限或命中阻塞判定，否则继续执行，不额外询问是否继续，也不把 `🔄 下一步` 当作单轮结果或继续执行占位。
 每轮迭代必须完整走完以下八个阶段：

package/skills/commands/plan/SKILL.md

@@ -102,7 +102,7 @@ Trigger: ~plan [description]
 
 如果用户已明确表示继续执行，则视为授权成立，可直接继续执行。
 如果当前任务来自 `~auto`，且方案包已足够支撑实现、也未命中阻塞判定，则默认直接进入 `~build`，不再追加一次“是否开始执行”的询问。
-如果当前任务是显式 `~plan` 或 `~design`，且尚未获得执行授权，最终收尾按通用输出格式使用等待输入态：正文说明方案包与验证结果，`🔄 下一步` 写清待确认动作。
+如果当前任务是显式 `~plan` 或 `~design`，且尚未获得执行授权，最终回复按通用输出格式使用等待输入态：正文说明方案包与验证结果，`🔄 下一步` 写清待确认动作。
 
 ## 方案包要求
 

package/skills/commands/prd/SKILL.md

@@ -121,7 +121,7 @@ c. AI 总结该维度的决策结果，进入下一个维度
 
 如果用户已对当前 PRD 或继续执行作出明确同意，视为执行授权成立，可直接进入执行，或按需先补一轮 `~plan` 明确实现方案。
 如果当前任务来自 `~auto`，且 PRD 已整理成可执行任务、也未命中阻塞判定，则默认继续进入 `~build`，必要时先补一轮轻量 `~plan`，不再额外询问一次“是否开始执行”。
-如果当前任务是显式 `~prd`，且尚未获得执行授权，最终收尾按通用输出格式使用等待输入态：正文说明 PRD / 任务 / 契约结果，`🔄 下一步` 写清待确认动作。
+如果当前任务是显式 `~prd`，且尚未获得执行授权，最终回复按通用输出格式使用等待输入态：正文说明 PRD / 任务 / 契约结果，`🔄 下一步` 写清待确认动作。
 
 ### 6. 继续执行
 

package/skills/commands/test/SKILL.md

@@ -11,7 +11,7 @@ Trigger: ~test [scope]
 1. 确定测试范围：
    - 无参数：为最近变更的文件编写测试
    - 指定文件/模块：为指定范围编写测试
-   - Codex active goal 下无参数：从 `tasks.md` 未完成项、`contract.json` 与 `state_path` 推导本轮测试范围
+   - Codex active goal 下无参数：从 `tasks.md` 未完成项、`contract.json` 与 `state_path` 推导本次测试范围
 2. 按 hello-* 技能查找路径读取 hello-test SKILL.md，按其 TDD 规范和边界用例要求编写测试
 3. 运行测试确认全部通过
 4. 同步直接相关的任务状态，报告覆盖情况和遗漏；测试通过只作为 goal 交付证据，不直接标记 goal complete

package/skills/commands/verify/SKILL.md

@@ -12,13 +12,13 @@ Trigger: ~verify [scope]
    - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它
    - 即使命令通过，也不能越过当前方案包边界：不完整方案包不能视为可信交付记录，未闭合方案包不能被整体报告为已完成
    - 当推荐路径已进入 `~verify` / 收尾时，优先把本命令用于审查、验真和交付收尾
-   - 若当前存在活跃方案包，先读取 `requirements.md`、`plan.md`、`tasks.md`、`contract.json`，把它们当作本轮验证契约；不要只看命令结果
-   - 若本轮运行在 Codex active goal 下，按 active goal 关联方案包和 `state_path` 复核范围；`/goal` 只负责续跑，不改变验证契约
-   - 若 `contract.json` 声明 `advisor.required=true` 或 `ui.styleAdvisor.required=true`，则本轮还必须补齐当前会话 `artifacts/advisor.json`；advisor / style advisor 都是可选能力，不是默认常驻步骤
-   - 若 `contract.json` 声明 `ui.visualValidation.required=true`，则本轮还必须补齐当前会话 `artifacts/visual.json`；视觉验收优先用截图/浏览器工具，没有工具时才降级为结构化代码级自检
+   - 若当前存在活跃方案包，先读取 `requirements.md`、`plan.md`、`tasks.md`、`contract.json`，把它们当作当前验证契约；不要只看命令结果
+   - 若当前运行在 Codex active goal 下，按 active goal 关联方案包和 `state_path` 复核范围；`/goal` 只负责续跑，不改变验证契约
+   - 若 `contract.json` 声明 `advisor.required=true` 或 `ui.styleAdvisor.required=true`，则本次验证还必须补齐当前会话 `artifacts/advisor.json`；advisor / style advisor 都是可选能力，不是默认常驻步骤
+   - 若 `contract.json` 声明 `ui.visualValidation.required=true`，则本次验证还必须补齐当前会话 `artifacts/visual.json`；视觉验收优先用截图/浏览器工具，没有工具时才降级为结构化代码级自检
 1. 先决定验证分流：
    - 若当前上下文中已注入“验证分流”，先按该分流执行
-   - 用户显式使用 `~review` 时，即使本轮没有注入分流，也按审查优先起步
+   - 用户显式使用 `~review` 时，即使当前没有注入分流，也按审查优先起步
    - 若没有注入分流、也不是 `~review`，默认先做全量验证；执行中一旦发现高风险流程、关键权限/配置/迁移/发布边界或明显未覆盖的风险点，立即补做 `hello-review`
 2. 审查优先模式：
    - 获取变更范围：无参数默认未提交变更；`staged` 代表暂存区；指定文件/目录则只审查对应范围

package/skills/hello-review/SKILL.md

@@ -32,7 +32,7 @@ description: 审查代码变更、检查 PR、review 代码质量，或用户要
 - 审查结束时必须单独给出一行“审查结论：...”
 - 若发现阻塞问题，结论中明确写出存在问题，并在正文中为每个问题附文件定位
 - 若未发现阻塞问题，明确写“审查结论：未发现阻塞问题。”
-- 若当前项目已初始化，或本轮审查结果需要进入后续交付检查或收尾，审查结论确定后立即调用 `scripts/review-state.mjs write` 写当前会话 `artifacts/review.json`
+- 若当前项目已初始化，或当前审查结果需要进入后续交付检查或收尾，审查结论确定后立即调用 `scripts/review-state.mjs write` 写当前会话 `artifacts/review.json`
 - `artifacts/review.json` 必须使用结构化字段记录：`outcome`（`clean` / `findings`）、`conclusion`、`findings`、`fileReferences`
 - 不要依赖“审查结论：...”这行让运行时再从自然语言里猜机器结论；这行只服务于人类阅读
 

package/skills/hello-subagent/SKILL.md

@@ -18,7 +18,7 @@ description: 使用子代理执行任务、并行开发、分派工作时使用
 
 ## 协调规范
 - 使用子代理时，主代理作为控制器跟踪进度
-- 主代理只有在本轮最终收尾时才可使用 HelloAGENTS 外层输出格式。
+- 主代理只有在当前对话的最终回复中才可使用 HelloAGENTS 外层输出格式。
 - 团队协作中的进度与状态汇报都属于中间输出，不得包装 HelloAGENTS 外层输出格式。
 - 子代理不得调用 `helloagents-turn-state write` 代替主代理写完成态或等待态；需要运行时状态信号时只由主代理写入
 - 子代理完成后执行双阶段审查：

package/skills/hello-ui/SKILL.md

@@ -47,7 +47,7 @@ description: 已进入显式 UI 工作流、全局模式中的 UI 任务、已
 - 组件边界：哪些能力做成复用组件，哪些只保留在当前页面；避免把一次性布局抽成错误的“通用组件”
 - 状态矩阵：当前界面涉及的加载、空、错误、成功、禁用、危险态分别如何呈现
 - 主题与适配：深浅色、响应式断点或平台尺寸、安全区、最小窗口/最小视口如何处理
-- 验收证据：本轮需要检查的关键视口、关键状态和关键截图点是什么
+- 验收证据：本次需要检查的关键视口、关键状态和关键截图点是什么
 
 ## 结构性规则
 

package/skills/hello-verify/SKILL.md

@@ -75,11 +75,11 @@ description: 声称工作完成前、提交代码前、创建 PR 前、报告任
 2. 逐项确认每个检查项，标记 [√] 并附带证据（如：`src/api.ts:42` 使用了参数化查询）
 3. 不适用的项标记 [-] 并说明原因
 4. 有未通过项 → 修复 → 重新运行验证循环
-5. 若当前存在方案包并准备最终收尾，优先调用 `scripts/closeout-state.mjs write` 写当前会话 `artifacts/closeout.json`，记录 `requirementsCoverage` 与 `deliveryChecklist` 两项结论；两项都必须包含 `status`（`PASS` / `BLOCKED`）和 `summary`
+5. 若当前存在方案包并准备最终回复，优先调用 `scripts/closeout-state.mjs write` 写当前会话 `artifacts/closeout.json`，记录 `requirementsCoverage` 与 `deliveryChecklist` 两项结论；两项都必须包含 `status`（`PASS` / `BLOCKED`）和 `summary`
 6. 若当前方案包要求 `review-first`，必须先确认当前会话 `artifacts/review.json` 已通过 `scripts/review-state.mjs write` 写成最新结构化证据；不要把审查自然语言消息直接当成交付证据
-7. 若 `contract.json` 中 `ui.visualValidation.required=true`，必须确认当前会话 `artifacts/visual.json` 已通过 `scripts/visual-state.mjs write` 写成最新结构化证据；若没有视觉验收证据，不得把本轮视为 UI 可交付
-8. 本地版本检查点：非只读任务完成验证且产生工作区变更时，若 `auto_commit_enabled=true`，最终收尾前自动执行本地提交；若 `auto_commit_enabled=false`，跳过这一步。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。显式 `~commit` 不受这个开关影响。不自动远程 `git push`，除非用户明确要求
-9. 若本轮需要运行时识别验证收尾状态，优先调用 `helloagents-turn-state write --kind complete --role main`；若因阻塞判定等待输入或因前置条件缺失而停下，写 `kind=waiting` 或 `kind=blocked`，并同时写 `reasonCategory` 与 `reason`；显式 `~auto` / `~loop` 下还要写 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`，不要让运行时从自然语言消息里猜状态
+7. 若 `contract.json` 中 `ui.visualValidation.required=true`，必须确认当前会话 `artifacts/visual.json` 已通过 `scripts/visual-state.mjs write` 写成最新结构化证据；若没有视觉验收证据，不得把当前结果视为 UI 可交付
+8. 本地版本检查点：非只读任务完成验证且产生工作区变更时，若 `auto_commit_enabled=true`，最终回复前自动执行本地提交；若 `auto_commit_enabled=false`，跳过这一步。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。显式 `~commit` 不受这个开关影响。不自动远程 `git push`，除非用户明确要求
+9. 若当前对话需要运行时识别验证收尾状态，优先调用 `helloagents-turn-state write --kind complete --role main`；若因阻塞判定等待输入或因前置条件缺失而停下，写 `kind=waiting` 或 `kind=blocked`，并同时写 `reasonCategory` 与 `reason`；显式 `~auto` / `~loop` 下还要写 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`，不要让运行时从自然语言消息里猜状态
 
 ## 需求追踪验证
 
@@ -88,9 +88,9 @@ description: 声称工作完成前、提交代码前、创建 PR 前、报告任
 2. 确认每条需求都有对应的任务实现，没有被静默丢弃
 3. 确认非目标章节列出的内容确实没有被实现（防止范围蔓延）
 4. 若 tasks.md 中定义了“完成标准”，逐项确认每个任务的完成标准确实成立，不能只因为代码存在或命令通过就视为完成
-5. 若存在 `contract.json`，逐项确认其中的 `verifyMode`、reviewer / tester 关注边界都已被本轮验证覆盖
-6. 若 `contract.json` 中 `advisor.required=true` 或 `ui.styleAdvisor.required=true`，额外确认当前会话 `artifacts/advisor.json` 已存在且结论为 clean；若没有 advisor 证据，不得把本轮视为可交付
-7. 若 `contract.json` 中 `ui.visualValidation.required=true`，额外确认当前会话 `artifacts/visual.json` 已存在、覆盖要求的关键 screens / states，且结论为 `PASS`；若没有视觉验收证据，不得把本轮视为 UI 可交付
+5. 若存在 `contract.json`，逐项确认其中的 `verifyMode`、reviewer / tester 关注边界都已被本次验证覆盖
+6. 若 `contract.json` 中 `advisor.required=true` 或 `ui.styleAdvisor.required=true`，额外确认当前会话 `artifacts/advisor.json` 已存在且结论为 clean；若没有 advisor 证据，不得把当前结果视为可交付
+7. 若 `contract.json` 中 `ui.visualValidation.required=true`，额外确认当前会话 `artifacts/visual.json` 已存在、覆盖要求的关键 screens / states，且结论为 `PASS`；若没有视觉验收证据，不得把当前结果视为 UI 可交付
 8. 发现遗漏 → 补充实现 → 重新验证
 
 ## 目标偏移检查