helloagents 3.0.33 → 3.0.35

package/scripts/workflow-core.mjs

@@ -20,6 +20,7 @@ function describeStateLabel(state) {
   }
   return '当前会话的状态文件'
 }
+
 export function classifyPlan(plan) {
   if (!plan) {
     return {
@@ -64,24 +65,14 @@ export function classifyPlan(plan) {
   }
 }
 
-export function determineVerifyMode(plan) {
+export function determineQaMode(plan) {
   if (!plan) return null
 
   if (plan.contractIssues.length > 0) {
     return {
       mode: 'metadata-first',
-      reason: '方案包缺少可信的结构化契约',
-      guidance: '验证分流：当前还不适合直接进入 reviewer / tester；先回到 ~plan / ~prd 补齐 `contract.json`，明确 `verifyMode`、`reviewerFocus` 和 `testerFocus`。',
-    }
-  }
-
-  if (plan.contract?.verifyMode === 'review-first') {
-    const reviewerFocus = plan.contract.reviewerFocus.join('；')
-    const testerFocus = plan.contract.testerFocus.join('；')
-    return {
-      mode: 'review-first',
-      reason: '方案契约已明确要求审查优先',
-      guidance: `验证分流：当前更适合审查优先；先执行 reviewer / hello-review 范围审查，再交给 tester / hello-verify 跑完整验证。${reviewerFocus ? ` reviewer 重点：${reviewerFocus}。` : ''}${testerFocus ? ` tester 重点：${testerFocus}。` : ''}`.trim(),
+      reason: '方案包缺少可信的结构化 QA 契约',
+      guidance: '质量闭环：当前还不适合直接进入 ~qa；先回到 ~plan / ~prd 补齐 `contract.json`，明确 `qaMode` 与 `qaFocus`。',
     }
   }
 
@@ -89,14 +80,16 @@ export function determineVerifyMode(plan) {
     return {
       mode: 'metadata-first',
       reason: 'tasks.md 仍缺少可信的任务元数据',
-      guidance: '验证分流：当前还不适合直接进入 reviewer / tester；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”。',
+      guidance: '质量闭环：当前还不适合直接进入 ~qa；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”。',
     }
   }
 
+  const qaMode = plan.contract?.qaMode === 'deep' ? 'deep' : 'standard'
+  const qaFocus = (plan.contract?.qaFocus || []).join('；')
   return {
-    mode: 'test-first',
-    reason: '方案契约已明确验证主路径，且任务契约已完整',
-    guidance: `验证分流：当前更适合测试优先；先执行 tester / hello-verify 跑完整验证，再针对失败点或关键边界补充 hello-review。${plan.contract?.testerFocus?.length ? ` tester 重点：${plan.contract.testerFocus.join('；')}。` : ''}`.trim(),
+    mode: qaMode,
+    reason: qaMode === 'deep' ? '方案契约已明确要求深度 qa-review' : '方案契约已明确要求统一 qa-review',
+    guidance: `质量闭环：当前统一使用 qa-review；先完成阻断性质量审查，再运行验证命令、修复失败项并留下最新 qa-review 证据。${qaFocus ? ` QA 重点：${qaFocus}。` : ''}`.trim(),
   }
 }
 
@@ -131,12 +124,13 @@ function collectStateSyncIssues(snapshot) {
   return issues
 }
 
-export function buildVerifyModeHintFromSnapshot(snapshot) {
+export function buildQaFocusHintFromSnapshot(snapshot) {
   const plan = getTargetPlans(snapshot)[0]
   if (!plan) return ''
   if (!plan.planSections['风险与验证'] && plan.taskSummary.total === 0) return ''
-  return determineVerifyMode(plan)?.guidance || ''
+  return determineQaMode(plan)?.guidance || ''
 }
+
 export function buildStateSyncHintFromSnapshot(snapshot) {
   const issues = collectStateSyncIssues(snapshot)
   if (issues.length === 0) return ''

package/scripts/workflow-plan-files.mjs

@@ -18,7 +18,7 @@ const PLAN_TEMPLATE_MARKERS = {
     /# \{项目\/功能名称\} — 实施规划/,
     /\[本次要解决的问题、范围边界、验收目标\]/,
     /\[关键决策及理由\]/,
-    /\[功能完成时必须为真的条件、关键验收点、reviewer \/ tester 关注边界\]/,
+    /\[功能完成时必须为真的条件、关键验收点、qaMode 与 qaFocus\]/,
   ],
   'tasks.md': [
     /# \{项目\/功能名称\} — 任务分解/,

package/scripts/workflow-recommendation.mjs

@@ -1,23 +1,21 @@
 import { getCloseoutEvidenceStatus } from './closeout-state.mjs'
 import { getAdvisorEvidenceStatus } from './advisor-state.mjs'
 import { getAdvisorRequirement, getVisualValidationRequirement } from './plan-contract.mjs'
-import { getReviewEvidenceStatus } from './review-state.mjs'
+import { getQaReviewEvidenceStatus } from './qa-review-state.mjs'
 import { getVisualEvidenceStatus } from './visual-state.mjs'
-import { getVerifyEvidenceStatus } from './verify-state.mjs'
 import {
   classifyPlan,
-  determineVerifyMode,
+  determineQaMode,
   getTargetPlans,
   normalizeTaskFile,
 } from './workflow-core.mjs'
 
 function getClosedPlanEvidenceStatus(cwd, plan, options = {}) {
-  const verifyMode = determineVerifyMode(plan)
+  const qaMode = determineQaMode(plan)
   const advisorRequirement = getAdvisorRequirement(plan.contract)
   const visualRequirement = getVisualValidationRequirement(plan.contract)
-  const verificationStatus = getVerifyEvidenceStatus(cwd, options)
-  const reviewStatus = getReviewEvidenceStatus(cwd, {
-    required: verifyMode?.mode === 'review-first',
+  const qaStatus = getQaReviewEvidenceStatus(cwd, {
+    required: qaMode?.mode !== 'metadata-first',
     ...options,
   })
   const advisorStatus = getAdvisorEvidenceStatus(cwd, {
@@ -31,26 +29,23 @@ function getClosedPlanEvidenceStatus(cwd, plan, options = {}) {
     states: visualRequirement.states,
     ...options,
   })
-  const verifyReady = !verificationStatus.required || verificationStatus.status === 'valid'
-  const reviewReady = !reviewStatus.required || reviewStatus.status === 'valid'
+  const qaReady = !qaStatus.required || qaStatus.status === 'valid'
   const advisorReady = !advisorStatus.required || advisorStatus.status === 'valid'
   const visualReady = !visualStatus.required || visualStatus.status === 'valid'
   const closeoutStatus = getCloseoutEvidenceStatus(cwd, {
-    required: verifyReady && reviewReady && advisorReady && visualReady,
+    required: qaReady && advisorReady && visualReady,
     ...options,
   })
 
   return {
-    verifyMode,
+    qaMode,
     advisorRequirement,
     visualRequirement,
-    verificationStatus,
-    reviewStatus,
+    qaStatus,
     advisorStatus,
     visualStatus,
     closeoutStatus,
-    verifyReady,
-    reviewReady,
+    qaReady,
     advisorReady,
     visualReady,
     closeoutReady: !closeoutStatus.required || closeoutStatus.status === 'valid',
@@ -63,7 +58,7 @@ function buildConsolidateAction(recommendation) {
       phase: 'consolidate',
       mode: recommendation.mode,
       routeHint: recommendation.guidance,
-      gateHint: '交付把关：审查与验证证据已满足；先写当前会话 `artifacts/closeout.json` 记录需求覆盖与交付清单，再更新 `state_path` 并归档后才可交付。',
+      gateHint: '交付把关：qa-review 与附加证据已满足；先写当前会话 `artifacts/closeout.json` 记录需求覆盖与交付清单，再更新 `state_path` 并归档后才可交付。',
     }
   }
 
@@ -75,8 +70,8 @@ function buildConsolidateAction(recommendation) {
   }
 }
 
-function buildVerifyAction(plan, verifyMode) {
-  if (!verifyMode) return null
+function buildQaAction(plan, qaMode) {
+  if (!qaMode) return null
   const advisorRequirement = getAdvisorRequirement(plan.contract)
   const visualRequirement = getVisualValidationRequirement(plan.contract)
   const extraChecks = []
@@ -87,30 +82,23 @@ function buildVerifyAction(plan, verifyMode) {
     extraChecks.push('完成视觉验收并写入当前会话 `artifacts/visual.json`')
   }
   const gateSuffix = extraChecks.length > 0 ? ` ${extraChecks.join('，')}，再进入 CONSOLIDATE。` : ''
-  if (verifyMode.mode === 'review-first') {
-    return {
-      phase: 'verify',
-      mode: verifyMode.mode,
-      routeHint: verifyMode.guidance,
-      gateHint: `交付把关：进入 CONSOLIDATE 前，必须先完成 reviewer / hello-review 范围审查，再完成 tester / hello-verify 全量验证，并留下最新验证证据；两步都通过后才可交付。${gateSuffix}`.trim(),
-    }
-  }
-  if (verifyMode.mode === 'metadata-first') {
+
+  if (qaMode.mode === 'metadata-first') {
     return {
-      phase: 'verify',
-      mode: verifyMode.mode,
-      routeHint: verifyMode.guidance,
+      phase: 'plan',
+      mode: qaMode.mode,
+      routeHint: qaMode.guidance,
       gateHint: plan.contractIssues.length > 0
-        ? '交付把关：当前还不能进入 CONSOLIDATE；先补齐 `contract.json` 中的 `verifyMode`、`reviewerFocus`、`testerFocus`，再进入 reviewer / tester。'
-        : '交付把关：当前还不能进入 CONSOLIDATE；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”，再进入 reviewer / tester。',
+        ? '交付把关：当前还不能进入 CONSOLIDATE；先补齐 `contract.json` 中的 `qaMode` 与 `qaFocus`，再进入 ~qa。'
+        : '交付把关：当前还不能进入 CONSOLIDATE；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”，再进入 ~qa。',
     }
   }
 
   return {
-    phase: 'verify',
-    mode: verifyMode.mode,
-    routeHint: verifyMode.guidance,
-    gateHint: `交付把关：进入 CONSOLIDATE 前，先完成 tester / hello-verify 全量验证并留下最新验证证据，再针对失败点或关键边界补充 hello-review；确认通过后才可交付。${gateSuffix}`.trim(),
+    phase: 'qa',
+    mode: qaMode.mode,
+    routeHint: qaMode.guidance,
+    gateHint: `交付把关：进入 CONSOLIDATE 前，必须完成 qa-review 全量质量闭环，并留下最新 qa-review 证据。${gateSuffix}`.trim(),
   }
 }
 
@@ -122,19 +110,19 @@ export function buildDeliveryActionFromSnapshot(snapshot, cwd, recommendation =
   }
 
   const plan = getTargetPlans(snapshot)[0]
-  if (recommendation.nextCommand === 'verify' && plan) {
-    return buildVerifyAction(plan, determineVerifyMode(plan))
+  if (recommendation.nextCommand === 'qa' && plan) {
+    return buildQaAction(plan, determineQaMode(plan))
   }
   if (recommendation.nextCommand === 'build') {
     return {
       phase: 'build',
-      gateHint: '交付把关：当前还不能报告完成；先回到 ~build 完成剩余任务，再进入 ~verify。',
+      gateHint: '交付把关：当前还不能报告完成；先回到 ~build 完成剩余任务，再进入 ~qa。',
     }
   }
   if (recommendation.nextCommand === 'plan') {
     return {
       phase: 'plan',
-      gateHint: '交付把关：当前还不能报告完成；先回到 ~plan 修复或补齐当前方案包，再进入 ~build / ~verify。',
+      gateHint: '交付把关：当前还不能报告完成；先回到 ~plan 修复或补齐当前方案包，再进入 ~build / ~qa。',
     }
   }
 
@@ -152,13 +140,13 @@ function buildPlanRecommendation(scopeLabel, plan, classification) {
     status: classification.status,
     details: classification.details,
     nextCommand: 'plan',
-    nextPath: '~plan -> ~build / ~verify',
+    nextPath: '~plan -> ~build / ~qa',
     summary: classification.status === 'incomplete'
       ? `${scopeLabel} "${plan.planName}" 仍不完整（${classification.details.join('；')}）。`
       : `${scopeLabel} "${plan.planName}" 尚未形成可执行任务清单。`,
     guidance: classification.status === 'incomplete'
-      ? '优先先走 ~plan 修复或补全当前方案包，再进入实现或验证；不要把不完整的结构化产物直接当成可交付依据。'
-      : '先回到 ~plan 补齐 tasks.md 的原子任务，再进入实现、验证或收尾。',
+      ? '优先先走 ~plan 修复或补全当前方案包，再进入实现或 qa-review；不要把不完整的结构化产物直接当成可交付依据。'
+      : '先回到 ~plan 补齐 tasks.md 的原子任务，再进入实现、qa-review 或收尾。',
   }
 }
 
@@ -169,23 +157,23 @@ function buildInProgressRecommendation(scopeLabel, plan, classification) {
     status: classification.status,
     details: classification.details,
     nextCommand: 'build',
-    nextPath: '~build -> ~verify',
+    nextPath: '~build -> ~qa',
     summary: `${scopeLabel} "${plan.planName}" 仍有 ${classification.openCount} 个未完成任务。`,
-    guidance: '若用户是在继续当前功能、落实既有方案、或让你“继续做完”，优先复用现有 requirements.md / plan.md / tasks.md 进入 ~build；完成当前实现后再进入 ~verify。除非用户明确要求重规划或现有方案已失效，不要重新回到 ~idea。',
+    guidance: '若用户是在继续当前功能、落实既有方案、或让你“继续做完”，优先复用现有 requirements.md / plan.md / tasks.md 进入 ~build；完成当前实现后再进入 ~qa。除非用户明确要求重规划或现有方案已失效，不要重新回到 ~idea。',
   }
 }
 
 function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
   const closedPlanEvidence = getClosedPlanEvidenceStatus(cwd, plan, options)
-  if (closedPlanEvidence.verifyMode?.mode === 'metadata-first') {
+  if (closedPlanEvidence.qaMode?.mode === 'metadata-first') {
     return {
       scopeLabel,
       plan,
       status: 'closed',
-      nextCommand: 'verify',
-      nextPath: '~verify -> CONSOLIDATE',
-      summary: `${scopeLabel} "${plan.planName}" 的任务已全部闭合，但验证契约仍未结构化。`,
-      guidance: closedPlanEvidence.verifyMode.guidance,
+      nextCommand: 'plan',
+      nextPath: '~plan -> ~qa',
+      summary: `${scopeLabel} "${plan.planName}" 的任务已全部闭合，但 QA 契约仍未结构化。`,
+      guidance: closedPlanEvidence.qaMode.guidance,
     }
   }
 
@@ -199,10 +187,10 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       scopeLabel,
       plan,
       status: 'closed',
-      nextCommand: 'verify',
-      nextPath: '~verify -> CONSOLIDATE',
+      nextCommand: 'qa',
+      nextPath: '~qa -> CONSOLIDATE',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前 UI 契约仍要求独立 advisor 复查与视觉验收。`,
-      guidance: '先在 ~verify 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json`；再完成视觉验收并写入当前会话 `artifacts/visual.json`，记录 reason、tooling、screensChecked、statesChecked、status 与 summary；两项都通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json`；再完成视觉验收并写入当前会话 `artifacts/visual.json`，记录 reason、tooling、screensChecked、statesChecked、status 与 summary；两项都通过后再进入 CONSOLIDATE。',
     }
   }
 
@@ -211,10 +199,10 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       scopeLabel,
       plan,
       status: 'closed',
-      nextCommand: 'verify',
-      nextPath: '~verify -> CONSOLIDATE',
+      nextCommand: 'qa',
+      nextPath: '~qa -> CONSOLIDATE',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前契约仍要求独立 advisor 复查。`,
-      guidance: '先在 ~verify 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json` 记录复查原因、focus、来源与结论；advisor 通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json` 记录复查原因、focus、来源与结论；advisor 通过后再进入 CONSOLIDATE。',
     }
   }
 
@@ -223,25 +211,25 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       scopeLabel,
       plan,
       status: 'closed',
-      nextCommand: 'verify',
-      nextPath: '~verify -> CONSOLIDATE',
+      nextCommand: 'qa',
+      nextPath: '~qa -> CONSOLIDATE',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前 UI 契约仍要求视觉验收。`,
-      guidance: '先在 ~verify 阶段完成视觉验收，并写入当前会话 `artifacts/visual.json` 记录 reason、tooling、screensChecked、statesChecked、status 与 summary；视觉验收通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成视觉验收，并写入当前会话 `artifacts/visual.json` 记录 reason、tooling、screensChecked、statesChecked、status 与 summary；视觉验收通过后再进入 CONSOLIDATE。',
     }
   }
 
-  if (closedPlanEvidence.verifyReady && closedPlanEvidence.reviewReady && closedPlanEvidence.advisorReady && closedPlanEvidence.visualReady) {
+  if (closedPlanEvidence.qaReady && closedPlanEvidence.advisorReady && closedPlanEvidence.visualReady) {
     return {
       scopeLabel,
       plan,
       status: 'closed',
       stage: 'consolidate',
       mode: closedPlanEvidence.closeoutReady ? 'ready' : 'closeout-pending',
-      nextCommand: 'verify',
+      nextCommand: 'qa',
       nextPath: 'CONSOLIDATE',
       summary: closedPlanEvidence.closeoutReady
         ? `${scopeLabel} "${plan.planName}" 的任务与交付证据已闭合。`
-        : `${scopeLabel} "${plan.planName}" 的任务、审查与验证已闭合。`,
+        : `${scopeLabel} "${plan.planName}" 的任务与 qa-review 已闭合。`,
       guidance: closedPlanEvidence.closeoutReady
         ? '当前进入 CONSOLIDATE：更新 `state_path`、知识文件并归档方案后即可交付；不要无故重开新的方案包或重新跑一遍无关验证。'
         : '当前进入 CONSOLIDATE：先写当前会话 `artifacts/closeout.json` 记录需求覆盖与交付清单，再更新 `state_path` 并归档后交付。',
@@ -252,10 +240,10 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
     scopeLabel,
     plan,
     status: 'closed',
-    nextCommand: 'verify',
-    nextPath: '~verify -> CONSOLIDATE',
+    nextCommand: 'qa',
+    nextPath: '~qa -> CONSOLIDATE',
     summary: `${scopeLabel} "${plan.planName}" 的任务已全部闭合。`,
-    guidance: '若用户是在做收尾、验真、复查或准备交付，优先走 ~verify 或 CONSOLIDATE；不要无故重开新的方案包。',
+    guidance: '若用户是在做收尾、验真、复查或准备交付，优先走 ~qa 或 CONSOLIDATE；不要无故重开新的方案包。',
   }
 }
 
@@ -323,9 +311,9 @@ export function buildOrchestrationHintFromSnapshot(snapshot, cwd, recommendation
   if (recommendation.nextCommand === 'build') {
     return buildBuildOrchestrationHint(plan)
   }
-  if (recommendation.nextCommand === 'verify' && plan.taskSummary.total >= 1) {
+  if (recommendation.nextCommand === 'qa' && plan.taskSummary.total >= 1) {
     const action = buildDeliveryActionFromSnapshot(snapshot, cwd, recommendation)
-    if (action?.phase === 'verify') {
+    if (action?.phase === 'qa') {
       return `编排提示：当前已进入收尾；${[action.routeHint, action.gateHint].filter(Boolean).join(' ')}`
     }
   }

package/scripts/workflow-state.mjs

@@ -1,10 +1,10 @@
 import { basename } from 'node:path'
 
 import {
+  buildQaFocusHintFromSnapshot,
   buildStateRoleHintFromSnapshot,
   buildStateSyncHintFromSnapshot,
   buildUiContractHint,
-  buildVerifyModeHintFromSnapshot,
   getWorkflowSnapshot,
   readStateSnapshot,
   listPlanPackages,
@@ -54,14 +54,14 @@ export function buildWorkflowRouteHint(cwd, options = {}) {
   return `${recommendation.summary} 当前应执行 ~${recommendation.nextCommand}。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
 }
 
-function buildCommandRouteMessage(skillName, recommendation, verifyModeHint) {
+function buildCommandRouteMessage(skillName, recommendation, qaFocusHint) {
   if (skillName === 'auto') {
     return recommendation.stage === 'consolidate'
       ? `当前工作流约束：${recommendation.summary} 本次 ~auto 应直接完成当前收尾。${recommendation.guidance} 未命中阻塞判定前不要停下，也不要把收尾动作写成“下一步建议”。`
       : `当前工作流约束：${recommendation.summary} 本次 ~auto 的执行主路径：${recommendation.nextPath}。${recommendation.guidance} 命中主路径后继续执行后续阶段；未触发阻塞判定前不要停下，也不要把阶段结果写成“下一步建议”。`
   }
   if (skillName === 'loop') {
-    return `当前工作流约束：用户已显式使用 ~loop，应按 ~loop 的循环规则直接执行。现有工作流只作上下文参考：${recommendation.summary} ${recommendation.guidance} 除非达到迭代上限、达成目标或命中阻塞判定，否则不要停下，也不要把单轮结果写成“下一步建议”。`
+    return `当前工作流约束：用户已显式使用 ~loop，应把它视为长任务入口，默认按“/goal -> ~auto -> ~qa”直接推进。现有工作流只作上下文参考：${recommendation.summary} ${recommendation.guidance} 若当前宿主不支持 /goal，则按 ~auto 持续推进，并在交付前强制进入 ~qa。未命中阻塞判定前不要停下，也不要把阶段结果写成“下一步建议”。`
   }
   if (skillName === 'plan') {
     if (recommendation.stage === 'consolidate') {
@@ -79,13 +79,13 @@ function buildCommandRouteMessage(skillName, recommendation, verifyModeHint) {
       ? `当前工作流约束：${recommendation.summary} 当前应执行 ~build。${recommendation.guidance}`
       : `当前工作流约束：${recommendation.summary} 当前不该继续 ~build；先按 ~${recommendation.nextCommand} 处理。只有在用户明确提出新增实现范围时，才继续 ~build。`
   }
-  if (skillName === 'verify') {
+  if (skillName === 'qa') {
     if (recommendation.stage === 'consolidate') {
       return `当前工作流约束：${recommendation.summary} 当前应直接进入 CONSOLIDATE。${recommendation.guidance}`
     }
-    return recommendation.nextCommand === 'verify'
-      ? `当前工作流约束：${recommendation.summary} 当前应执行 ~verify。${recommendation.guidance}`
-      : `当前工作流约束：${recommendation.summary} 当前不该把 ~verify 当成越级入口；先按 ~${recommendation.nextCommand} 处理。即使执行 ~verify，也不能越过当前工作流边界。${verifyModeHint ? ` 若本次仅做阶段内审查或验真，${verifyModeHint}` : ''}`
+    return recommendation.nextCommand === 'qa'
+      ? `当前工作流约束：${recommendation.summary} 当前应执行 ~qa。${recommendation.guidance}`
+      : `当前工作流约束：${recommendation.summary} 当前不该把 ~qa 当成越级入口；先按 ~${recommendation.nextCommand} 处理。即使执行 ~qa，也不能越过当前工作流边界。${qaFocusHint ? ` 若本次只是阶段内收尾，${qaFocusHint}` : ''}`
   }
   return `当前工作流约束：${recommendation.summary} 当前应执行 ~${recommendation.nextCommand}。${recommendation.guidance}`
 }
@@ -104,7 +104,7 @@ export function buildCommandRouteHint(skillName, cwd, options = {}) {
     return contextHints.join(' ')
   }
 
-  const message = buildCommandRouteMessage(skillName, recommendation, buildVerifyModeHintFromSnapshot(snapshot))
+  const message = buildCommandRouteMessage(skillName, recommendation, buildQaFocusHintFromSnapshot(snapshot))
   return [message, ...contextHints].join(' ')
 }
 

package/skills/commands/auto/SKILL.md

@@ -1,18 +1,18 @@
 ---
 name: ~auto
-description: 自动执行命令 — 自动选择并依次执行 ~idea / ~plan / ~build / ~verify / ~prd，默认持续推进直到交付完成（~auto 命令）
+description: 自动执行命令 — 自动选择并依次执行 ~idea / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）
 policy:
   allow_implicit_invocation: false
 ---
 Trigger: ~auto <任务描述>
 
-`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态，在 `~idea`、`~plan`、`~build`、`~verify`、`~prd` 之间选择合适主路径，并连续推进。
+`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态，在 `~idea`、`~plan`、`~build`、`~qa`、`~prd` 之间选择合适主路径，并连续推进。
 `~auto` 不止做一次选路；主路径一旦确定，就按需要继续执行后续阶段，默认持续推进直到完成交付，只有命中 HelloAGENTS 阻塞判定时才停下。
 
 ## 铁律
 - 不为了“自动化”而强行走重流程
 - 复杂度与风险不足以支撑更重路径时，优先选更轻但能保证质量的路线
-- `T3` 高风险或不可逆操作默认不直接进入 `~build`；优先先走 `~plan` 或 `~prd`，纯审查/纯验证请求才可先进入 `~verify`
+- `T3` 高风险或不可逆操作默认不直接进入 `~build`；优先先走 `~plan` 或 `~prd`，纯质量审查、验真或收尾请求才可先进入 `~qa`
 - 主路径一旦确定，立即读取对应 command skill，并在阶段完成后继续执行后续阶段，避免同一任务重复探索或重复等待
 - 选路不替代授权；涉及外部副作用或高风险不可逆操作时，仍遵守 HelloAGENTS 阻塞判定与确认规则
 - 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若当前运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
@@ -25,8 +25,8 @@ Trigger: ~auto <任务描述>
 - 若当前上下文中已注入“当前工作流提示”或“当前工作流约束”，优先服从其中的推荐下一命令 / 主路径
 - 默认原则：
   - 活跃方案包不完整或缺少任务清单 → 先 `~plan`
-  - 活跃方案包仍在执行 → 先 `~build`，完成当前实现后再 `~verify`
-  - 活跃方案包已闭合 → 先 `~verify` 或收尾
+  - 活跃方案包仍在执行 → 先 `~build`，完成当前实现后再 `~qa`
+  - 活跃方案包已闭合 → 先 `~qa` 或收尾
   - Codex active goal 已关联方案包 → 按 `tasks.md` 未完成 AFK 项、`contract.json` 与 `state_path` 确定主路径，不把 goal 目标原文替代方案包
 - 只有当用户明确要求换方向、重做方案，或现有方案已失效时，才偏离当前推荐重新规划
 
@@ -36,7 +36,7 @@ Trigger: ~auto <任务描述>
 - 若当前上下文没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
 - 选路优先级：
   - 纯探索 / 点子 / 方向比较 → `~idea`
-  - 明确要求验证 / 审查 / 跑检查 → `~verify`
+  - 明确要求质量审查 / 验真 / 跑检查 / 收尾 → `~qa`
   - 0 到 1 / 产品级 / 多维规格 → `~prd`
   - 多文件功能 / 架构变更 / 新项目规划 → `~plan`
   - 明确修复 / 小范围实现 / 按现有方案实现 → `~build`
@@ -44,28 +44,28 @@ Trigger: ~auto <任务描述>
 ### 2. 按 Tier 校正
 
 - `T0` → 保持在 `~idea`，不创建项目文件
-- `T1` → 在 `~build` / `~verify` 间选择最短可交付路径
+- `T1` → 在 `~build` / `~qa` 间选择最短可交付路径
 - `T2` → 需要结构化产物或范围未完全明确时优先 `~plan`
-- `T3` → 纯审查/验真走 `~verify`；其余默认 `~plan` 或 `~prd`，待方案与风险边界明确后再进入实现
+- `T3` → 纯质量审查/验真走 `~qa`；其余默认 `~plan` 或 `~prd`，待方案与风险边界明确后再进入实现
 
 ### 3. 读取对应命令并执行主路径
 
 - 选中 `idea` → 读取 `skills/commands/idea/SKILL.md`
 - 选中 `plan` → 读取 `skills/commands/plan/SKILL.md`
 - 选中 `build` → 读取 `skills/commands/build/SKILL.md`
-- 选中 `verify` → 读取 `skills/commands/verify/SKILL.md`
+- 选中 `qa` → 读取 `skills/commands/qa/SKILL.md`
 - 选中 `prd` → 读取 `skills/commands/prd/SKILL.md`
 
 不要额外读取未选中的 command skill。
 
 ### 4. 持续执行直到完成
 
-- 若主路径是 `~build` → 完成实现后继续进入 `~verify`，再进入收尾
+- 若主路径是 `~build` → 完成实现后继续进入 `~qa`，再进入收尾
 - 若主路径是 `~plan` → 方案包写入后，若当前任务来自 `~auto` 且未命中阻塞判定，直接继续进入 `~build`，不要把“方案已形成”当作最终停点
 - 若主路径是 `~prd` → PRD / 任务 / 契约写入后，若当前任务来自 `~auto` 且未命中阻塞判定，按当前结果继续进入 `~build`，必要时先补一轮轻量 `~plan`
-- 若主路径是 `~verify` → 完成审查 / 验证 / 收尾后结束
+- 若主路径是 `~qa` → 完成质量闭环 / 收尾后结束
 - 若主路径是 `~idea`，且用户本意就是探索/比较，则在探索输出后结束；若探索后已有明确方向且当前任务仍要求写文件或改代码，则继续进入 `~plan` 或 `~build`
-- 若 Codex active goal 的目标已满足 → 仍先完成 `~verify` 与 HelloAGENTS 收尾，再标记 goal complete；未满足时继续下一项可执行 AFK 任务
+- 若 Codex active goal 的目标已满足 → 仍先完成 `~qa` 与 HelloAGENTS 收尾，再标记 goal complete；未满足时继续下一项可执行 AFK 任务
 
 ### 5. 何时允许停下
 

package/skills/commands/build/SKILL.md

@@ -6,8 +6,8 @@ policy:
 ---
 Trigger: ~build [description]
 
-`~build` 是执行实现命令。它负责读取现有需求、方案包与项目上下文，完成实现、局部验证、修复循环，并把结果交给后续验证与收尾。
-执行 `~build` 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充实现前定位、实现约束，以及进入 `~verify` / 收尾前的实现边界。
+`~build` 是执行实现命令。它负责读取现有需求、方案包与项目上下文，完成实现、局部验证、修复循环，并把结果交给后续质量闭环与收尾。
+执行 `~build` 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充实现前定位、实现约束，以及进入 `~qa` / 收尾前的实现边界。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：状态文件只使用 `state_path`；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，知识库、`DESIGN.md`、`verify.yaml` 与方案包按当前上下文中已注入的项目知识/方案目录解析。
 
 ## 铁律
@@ -27,7 +27,7 @@ Trigger: ~build [description]
   - `tasks.md`
   - `contract.json`
   - 实现时优先把 `tasks.md` 中每个任务的“完成标准”当作本次实现约束，不要只按任务标题猜测范围
-  - `contract.json` 存在时，优先按其中的 `verifyMode`、`reviewerFocus`、`testerFocus` 理解后续验证边界
+  - `contract.json` 存在时，优先按其中的 `qaMode`、`qaFocus` 理解后续质量闭环边界
 - 若当前运行在 Codex active goal 下，按 `tasks.md` 未完成项、`contract.json` 与 `state_path` 恢复实现位置；不要自动创建新 goal，也不要把 goal 目标原文替代方案包
 - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它；只有推荐仍为 `~build`，或用户明确提出新增实现范围时，才继续 `~build`
 - 其余项目知识库与相关代码文件，按 HelloAGENTS 项目上下文要求读取
@@ -53,17 +53,16 @@ Trigger: ~build [description]
   - 每次编辑后主动跑确定性检查
 - 可并行任务通过子代理执行，但不同子代理不得改同一文件
 
-### 4. 验证与修复循环
+### 4. 局部验证与修复循环
 
-- 读取 `hello-verify` SKILL.md
-- 运行 lint / typecheck / test / build 等验证
+- 按当前任务与 `tasks.md` 中的“验证方式”运行 lint / typecheck / test / build 等局部验证
 - 若失败，修复后重跑
-- 若涉及 review 场景，可按需读取 `hello-review`
+- 若当前实现已接近交付，主动对照 `qaFocus` 自检本次改动是否覆盖关键风险
 
 ### 5. 交付前处理
 
 - 有方案包时，只同步本次实现直接影响的任务状态；未完成项保持打开
-- 当前实现已闭合、且需要进入交付或收尾时，转入 `~verify`
-- 若 Codex active goal 仍有未完成 AFK 任务，继续下一项可执行任务；若目标已满足，先转入 `~verify` 与 HelloAGENTS 收尾，再标记 goal complete
-- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界，按当前已加载的 HelloAGENTS 规则进入 VERIFY / CONSOLIDATE
+- 当前实现已闭合、且需要进入交付或收尾时，转入 `~qa`
+- 若 Codex active goal 仍有未完成 AFK 任务，继续下一项可执行任务；若目标已满足，先转入 `~qa` 与 HelloAGENTS 收尾，再标记 goal complete
+- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界，按当前已加载的 HelloAGENTS 规则进入 QA / CONSOLIDATE
 - 不在 `~build` 内把仍未闭合的方案包整体报告为已完成

package/skills/commands/commit/SKILL.md

@@ -27,5 +27,5 @@ Trigger: ~commit [message]
 提交后，继续复用上方已解析的同一份设置获取 `kb_create_mode`，不要再次读取 `~/.helloagents/helloagents.json`：
 - 0 = 跳过
 - 1 = 知识库已存在时自动同步（默认）
-- 2 = 编码任务在知识库已存在或全局模式下自动创建或同步
+- 2 = 编码任务在知识库已存在或当前项目已初始化时自动创建或同步
 同步范围与更新格式按当前已加载的 HelloAGENTS CONSOLIDATE 阶段执行。

package/skills/commands/help/SKILL.md

@@ -12,16 +12,14 @@ Trigger: ~help
 | 命令 | 说明 |
 |------|------|
 | ~idea | 轻量点子探索与方向比较 |
-| ~auto | 自动执行：自动选主路径并持续推进到执行 / 验证 / 收尾，除非命中真实阻塞 |
+| ~auto | 自动执行：自动选主路径并持续推进到实现 / 质量闭环 / 收尾，除非命中真实阻塞 |
 | ~plan | 结构化规划：需求澄清 + 方案确认 + 方案包 |
-| ~build | 执行实现：按需求或方案包完成实现与验证 |
+| ~build | 执行实现：按需求或方案包完成实现与局部验证 |
 | ~prd | 完整 PRD：头脑风暴式逐维度挖掘，生成现代产品需求文档 |
-| ~loop | 自主迭代优化：设定目标和指标，循环修改-验证-保留/回滚 |
-| ~wiki | 仅创建/同步项目知识库 |
-| ~init | 同 `~wiki` |
-| ~global | 初始化项目级全局模式 |
+| ~loop | 长任务入口：在 Codex 中优先走 `/goal -> ~auto -> ~qa` |
+| ~init | 初始化项目工作流并同步知识库 |
 | ~test | 为指定模块或最近变更编写完整测试 |
-| ~verify | 验证总入口：审查 + 运行验证命令 + 修复循环 |
+| ~qa | 统一质量总入口：审查 + 运行验证命令 + 修复循环 + 收尾前证据 |
 | ~commit | 规范化提交 + 知识库同步 |
 | ~clean | 清理临时文件和归档方案包 |
 | ~help | 显示此帮助 |
@@ -29,15 +27,15 @@ Trigger: ~help
 兼容别名：
 - `~do` → 等同 `~build`
 - `~design` → 等同 `~plan`
-- `~review` → 等同 `~verify` 的审查优先模式
+- `~review` → 等同 `~qa`
 
 ### 自动激活技能
-以下技能仅在全局模式或已初始化项目时自动激活（例如执行过 `~global`，或当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`）。
+以下技能仅在宿主全局模式或已初始化项目时自动激活（例如当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`，通常由 `~init` 建立）。
 纯标准模式、且项目未初始化时不会自动触发这些技能；但涉及 UI 的任务仍受 UI 质量基线约束。
 
 编码时：hello-ui, hello-api, hello-data, hello-security, hello-errors, hello-perf, hello-arch, hello-test
-特定场景：hello-debug, hello-subagent, hello-write, hello-review
-完成时：hello-verify, hello-reflect
+特定场景：hello-debug, hello-subagent, hello-write
+完成时：qa-review, hello-reflect
 
 ### 当前设置
 优先使用当前会话上下文中已注入的“当前用户设置”、该配置文件原始 JSON 或此前读取结果摘要显示；若会话上下文不存在该信息，或缺少下表任一配置项，才读取一次 `~/.helloagents/helloagents.json`，并在后续轮次复用。对 Codex 来说，首次对话前若当前上下文仍缺少这些配置项，或刚经历压缩/恢复后的首次对话，同样先读取一次再继续。
@@ -47,9 +45,9 @@ Trigger: ~help
 | 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 |
+| ralph_loop_enabled | true | 收尾 QA gate（显式 ~qa / ~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 |
+| 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 |