helloagents 3.0.19 → 3.0.21-beta.1

package/skills/commands/loop/SKILL.md

@@ -22,7 +22,7 @@ Trigger: ~loop <目标描述> [--iterations N] [--metric "命令"] [--direction
 2. 确保 `.helloagents/` 目录和 `state_path` 存在；文件不存在时按 `templates/STATE.md` 创建。`~loop` 必须维护这个状态文件，不受 `kb_create_mode` 控制；“主线目标”固定写本次优化目标，避免混入其他任务
 3. 运行指标命令获取基线值，记录到 results log
 4. 如有守卫命令，运行确认基线通过
-5. 创建当前会话的 `.helloagents/sessions/{branch}/{session}/artifacts/loop-results.tsv`
+5. 创建当前会话的 `.helloagents/sessions/{workspace}/{session}/artifacts/loop-results.tsv`
 6. 根据优化目标标记可能需要的 hello-* 质量技能（如性能优化标记 hello-perf，UI 优化标记 hello-ui）
 7. 重写 `state_path`：记录主线目标=当前优化目标、基线指标、守卫命令、下一步设为第一轮迭代的具体动作
 
@@ -36,7 +36,7 @@ iteration	commit	metric	delta	guard	status	description
 ## 八阶段循环
 
 `~loop` 的八阶段循环是统一执行流程（ROUTE/TIER→SPEC→PLAN→BUILD→VERIFY→CONSOLIDATE）在迭代优化场景下的特化形式。每轮迭代的“修改”阶段遵循已标记的 hello-* 质量技能规范，“验证”阶段遵循 hello-verify 的验证规范。
-执行 `~loop` 时，涉及公共阶段边界、阻塞判定与收尾要求的部分，仍按当前已加载 bootstrap 执行；本 skill 负责补充 loop 场景的迭代顺序与回滚规则。
+执行 `~loop` 时，涉及公共阶段边界、阻塞判定与收尾要求的部分，仍按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充 loop 场景的迭代顺序与回滚规则。
 若本轮运行在 Codex `/goal` 下，`/goal` 只作为外层长程续跑与预算控制；`~loop` 仍负责指标、守卫、实验提交、keep/revert、results log、`state_path` 与收尾验证，不把 `/goal` 当成循环逻辑本身。
 
 除非达到迭代上限或命中阻塞判定，否则继续执行，不额外询问是否继续，也不把 `🔄 下一步` 当作单轮结果或继续执行占位。

package/skills/commands/plan/SKILL.md

@@ -7,7 +7,7 @@ policy:
 Trigger: ~plan [description]
 
 `~plan` 是实现前的主规划命令。它负责需求澄清、方案设计、任务拆解与方案写入；直接显式执行 `~plan` 时，默认停在“形成可执行方案”，只有用户明确授权继续时才继续执行。
-执行 `~plan` 时，通用阶段边界按当前已加载 bootstrap 执行；本 skill 负责补充 `~plan` 的需求澄清、方案确认、方案包写入与继续执行要求。
+执行 `~plan` 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充 `~plan` 的需求澄清、方案确认、方案包写入与继续执行要求。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：状态文件只使用 `state_path`；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，知识库、`DESIGN.md` 与 `plans/` / `archive/` 按当前上下文中已注入的项目知识/方案目录解析。
 
 ## 铁律
@@ -22,7 +22,7 @@ Trigger: ~plan [description]
 ### 1. 上下文收集与需求澄清准备
 
 已有项目：
-- 按当前已加载 bootstrap 的“.helloagents/ 文件读取优先级”和“项目文件”规则恢复上下文；若当前消息明确要继续上次任务，或会话刚经历恢复 / 压缩，先读取 `state_path`，再用当前用户消息、显式命令、活跃方案包 / PRD 与代码事实确认当前任务
+- 按当前已加载的 HelloAGENTS 规则恢复上下文，并遵循“.helloagents/ 文件读取优先级”和“项目文件”要求；若当前消息明确要继续上次任务，或会话刚经历恢复 / 压缩，先读取 `state_path`，再用当前用户消息、显式命令、活跃方案包 / PRD 与代码事实确认当前任务
 - 在需求澄清前，至少确认 `.helloagents/context.md`、`.helloagents/guidelines.md`（按当前项目存储模式解析）；涉及 UI 时，如存在 `.helloagents/DESIGN.md`（按当前项目存储模式解析），一并读取现有设计契约
 - 只扫描与当前需求直接相关的代码文件，用于形成假设和识别约束
 
@@ -75,9 +75,9 @@ Trigger: ~plan [description]
 ### 5. 写入方案包
 
 将确认的方案写入本地项目：
-- 按当前已加载 bootstrap 的 `.helloagents/` 与流程状态规则，确保最小项目状态已建立
-- 创建 `.helloagents/plans/YYYYMMDDHHMM_{feature}/`（按当前项目存储模式解析）
-- 按模板写入：
+- 按当前已加载的 HelloAGENTS 规则建立 `.helloagents/` 与最小流程状态
+- 创建方案包目标目录：`.helloagents/plans/YYYYMMDDHHMM_{feature}/`（按当前项目存储模式解析；repo-shared 时写入当前项目方案目录）
+- 以 `{HELLOAGENTS_READ_ROOT}/templates/plans/` 为源模板，在上述方案包目标目录内写入：
   - `requirements.md`
   - `plan.md`
   - `tasks.md`
@@ -91,7 +91,7 @@ Trigger: ~plan [description]
 - 涉及 UI 的项目：生成或更新 `.helloagents/DESIGN.md`（按当前项目存储模式解析）；若原文件不存在，先按模板建立最小设计契约，再写入已确认的稳定设计决策
 - 重写 `state_path`，其中“主线目标”写本次规划要完成的目标，不保留其他任务的内容
 
-知识库完整创建与归档按当前已加载 bootstrap 的后续规则执行。
+知识库完整创建与归档按当前已加载的 HelloAGENTS 规则继续处理。
 
 ### 6. 执行决策
 
@@ -102,7 +102,7 @@ Trigger: ~plan [description]
 
 如果用户已明确表示继续执行，则视为授权成立，可直接继续执行。
 如果当前任务来自 `~auto`，且方案包已足够支撑实现、也未命中阻塞判定，则默认直接进入 `~build`，不再追加一次“是否开始执行”的询问。
-如果当前任务是显式 `~plan` 或 `~design`，且尚未获得执行授权，收尾必须使用 `❓等待输入`，下一步写清待确认的执行动作。
+如果当前任务是显式 `~plan` 或 `~design`，且尚未获得执行授权，最终收尾按通用输出格式使用等待输入态：正文说明方案包与验证结果，`🔄 下一步` 写清待确认动作。
 
 ## 方案包要求
 

package/skills/commands/prd/SKILL.md

@@ -7,12 +7,12 @@ policy:
 Trigger: ~prd [description]
 
 执行 `~prd` 时，不读取 `~plan` 的 command skill；只有当前流程明确需要时，才继续读取对应的 hello-* 技能。
-执行 `~prd` 时，通用阶段边界按当前已加载 bootstrap 执行；本 skill 负责补充规格探索、PRD 写入与继续执行要求。
+执行 `~prd` 时，通用阶段边界按当前已加载的 HelloAGENTS 规则执行；本 skill 负责补充规格探索、PRD 写入与继续执行要求。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：状态文件只使用 `state_path`；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，知识库、`DESIGN.md` 与 `plans/` / `archive/` 按当前上下文中已注入的项目知识/方案目录解析。
 
 ## 铁律
 - 在用户确认方案之前，禁止编写任何实现代码、创建任何文件、或执行任何实现操作。
-- 每个维度的选项必须体现当前前沿水准。若当前已加载 bootstrap 含审美/体验规则则遵循其要求；否则至少给出具体、可执行、非泛化的视觉特征，不确定时主动搜索查阅。
+- 每个维度的选项必须体现当前前沿水准。若当前已加载的 HelloAGENTS 规则含审美/体验要求则遵循其要求；否则至少给出具体、可执行、非泛化的视觉特征，不确定时主动搜索查阅。
 - 用户说"跳过"某维度 → 跳过，不生成该文件。不强迫用户讨论不关心的维度。
 - 大项目检测：涉及多个独立子系统时，先帮用户分解为子项目，每个子项目走独立的 ~prd 循环。
 - 若当前任务来自 `~auto`，则 PRD / 任务 / 契约写入后默认继续执行；只有真实阻塞时才停在规格阶段。
@@ -58,7 +58,7 @@ Trigger: ~prd [description]
 ### 1. 上下文收集
 
 已有项目：
-- 按当前已加载 bootstrap 的“.helloagents/ 文件读取优先级”和“项目文件”规则恢复上下文；若当前消息明确要继续上次任务，或会话刚经历恢复 / 压缩，先读取 `state_path`，再用当前用户消息、显式命令、活跃方案包 / PRD 与代码事实确认当前任务
+- 按当前已加载的 HelloAGENTS 规则恢复上下文，并遵循“.helloagents/ 文件读取优先级”和“项目文件”要求；若当前消息明确要继续上次任务，或会话刚经历恢复 / 压缩，先读取 `state_path`，再用当前用户消息、显式命令、活跃方案包 / PRD 与代码事实确认当前任务
 - 在进入维度探索前，至少确认 `.helloagents/context.md`、`.helloagents/guidelines.md`，并只扫描与当前产品范围直接相关的代码和配置
 - 若 `.helloagents/context.md` 已有领域语言，PRD 中统一沿用；发现术语冲突或歧义时，先澄清再写入
 
@@ -99,7 +99,7 @@ c. AI 总结该维度的决策结果，进入下一个维度
 ### 4. 写入方案包
 
 将讨论结果写入本地项目：
-- 按当前已加载 bootstrap 的 `.helloagents/` 与流程状态规则，确保最小项目状态已建立；这是方案包写入的前置操作，不受 kb_create_mode 开关控制
+- 按当前已加载的 HelloAGENTS 规则建立 `.helloagents/` 与最小流程状态；这是方案包写入的前置操作，不受 kb_create_mode 开关控制
 - 创建 `.helloagents/plans/YYYYMMDDHHMM_{feature}/prd/`（按当前项目存储模式解析）
 - 按 templates/plans/prd/ 的模板格式，仅写入用户未跳过的维度文件
 - 生成 tasks.md（每个任务默认是端到端垂直切片，标注 AFK / HITL、依赖、具体文件路径、预期变更、完成标准与验证方式；任务独立可验证）
@@ -121,12 +121,13 @@ c. AI 总结该维度的决策结果，进入下一个维度
 
 如果用户已对当前 PRD 或继续执行作出明确同意，视为执行授权成立，可直接进入执行，或按需先补一轮 `~plan` 明确实现方案。
 如果当前任务来自 `~auto`，且 PRD 已整理成可执行任务、也未命中阻塞判定，则默认继续进入 `~build`，必要时先补一轮轻量 `~plan`，不再额外询问一次“是否开始执行”。
+如果当前任务是显式 `~prd`，且尚未获得执行授权，最终收尾按通用输出格式使用等待输入态：正文说明 PRD / 任务 / 契约结果，`🔄 下一步` 写清待确认动作。
 
 ### 6. 继续执行
 
-按 tasks.md 逐项完成，每项进入当前已加载 bootstrap 中定义的统一执行流程，完成后同步重写 `state_path`。
+按 tasks.md 逐项完成，每项进入当前已加载的 HelloAGENTS 统一执行流程，完成后同步重写 `state_path`。
 任务状态标记仅写入 tasks.md、验收清单或验证结果；普通说明、方案解释、状态汇报不用 [√] / [-] / [ ]。
-所有任务完成后进入当前已加载 bootstrap 中定义的 VERIFY / CONSOLIDATE 收尾阶段。
+所有任务完成后进入当前已加载的 HelloAGENTS VERIFY / CONSOLIDATE 收尾阶段。
 可并行的任务标记后用子代理并行执行（不同子代理不改同一文件）。
 执行过程中遇到阻塞（依赖缺失、指令不清、验证反复失败）→ 立即停下询问用户，不猜测。
 执行过程中遇到高风险操作（删除文件/修改配置/数据库变更）→ 暂停确认。

package/skills/commands/verify/SKILL.md

@@ -9,7 +9,7 @@ Trigger: ~verify [scope]
 ## 流程
 
 0. 先对齐当前工作流状态：
-   - 若当前上下文中已注入“当前工作流约束”或“当前建议下一命令”，先服从它
+   - 若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它
    - 即使命令通过，也不能越过当前方案包边界：不完整方案包不能视为可信交付记录，未闭合方案包不能被整体报告为已完成
    - 当推荐路径已进入 `~verify` / 收尾时，优先把本命令用于审查、验真和交付收尾
    - 若当前存在活跃方案包，先读取 `requirements.md`、`plan.md`、`tasks.md`、`contract.json`，把它们当作本轮验证契约；不要只看命令结果
@@ -43,4 +43,4 @@ Trigger: ~verify [scope]
 
 ## 失败处理
 - 有失败 → 逐个修复，修复后重新运行对应审查或验证
-- 全部通过 → 进入当前已加载 bootstrap 的 CONSOLIDATE 收尾；若 Codex active goal 的目标也已满足，再标记 goal complete，并按交付边界报告完成
+- 全部通过 → 按当前已加载的 HelloAGENTS 规则进入 CONSOLIDATE 收尾；若 Codex active goal 的目标也已满足，再标记 goal complete，并按交付边界报告完成

package/skills/commands/wiki/SKILL.md

@@ -9,7 +9,7 @@ Trigger: ~wiki
 `~wiki` 是用户显式命令，仅创建、补全或同步项目知识库。
 
 `~wiki` 是显式知识库命令，不受 `kb_create_mode` 限制。
-执行 `~wiki` 时，`.helloagents/` 目录结构、模板格式和状态文件重写规则按当前已加载 bootstrap 执行；不写入项目级规则文件，也不创建项目级 HelloAGENTS 包根链接。
+执行 `~wiki` 时，`.helloagents/` 目录结构、模板格式和状态文件重写规则按当前已加载的 HelloAGENTS 规则执行；不写入项目级规则文件，也不创建项目级 HelloAGENTS 包根链接。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：状态文件只使用 `state_path`；若 `project_store_mode=repo-shared`，`context.md`、`guidelines.md`、`verify.yaml`、`CHANGELOG.md`、`DESIGN.md`、`modules/` 改按当前上下文中已注入的项目知识目录写入。
 
 ## 流程

package/skills/hello-arch/SKILL.md

@@ -21,7 +21,7 @@ description: 重构代码、调整模块结构、管理依赖、拆分文件、
 
 ## 代码组织
 - 按功能分组（feature-based），非按类型分组
-- 代码体积控制（同当前已加载 bootstrap 的编码原则）：文件/类预警 300 行、强制拆分 400 行，函数预警 40 行、强制拆分 60 行。例外：生成代码、大型测试夹具、迁移脚本、协议常量表
+- 代码体积控制（同 HelloAGENTS 编码原则）：文件/类预警 300 行、强制拆分 400 行，函数预警 40 行、强制拆分 60 行。例外：生成代码、大型测试夹具、迁移脚本、协议常量表
 - 公共逻辑提取到 shared/，但避免过早抽象
 - 三次重复才提取——两次相似不够
 
@@ -35,4 +35,4 @@ description: 重构代码、调整模块结构、管理依赖、拆分文件、
 - [ ] 文件/类不超过 400 行，函数不超过 60 行（例外类型除外，非压缩代码）
 - [ ] 依赖方向正确（外 → 内）
 - [ ] 变更范围可控
-- [ ] 技术选型符合当前已加载 bootstrap 的技术下限要求；若当前模式未加载质量下限章节，则至少满足技术选型原则且新项目无过时依赖
+- [ ] 技术选型符合 HelloAGENTS 技术下限；若当前模式未加载质量下限章节，则至少满足技术选型原则且新项目无过时依赖

package/skills/hello-errors/SKILL.md

@@ -36,4 +36,4 @@ description: 实现错误处理、try-catch、日志记录、监控、重试逻
 - [ ] 不暴露内部细节给用户
 - [ ] 外部调用有超时设置
 - [ ] 敏感信息已脱敏
-- [ ] 无静默失败：无空 catch 吞错误、无静默降级、无静默回退（见当前已加载 bootstrap 的“静默失败防护”规则）
+- [ ] 无静默失败：无空 catch 吞错误、无静默降级、无静默回退（见 HelloAGENTS“静默失败防护”）

package/skills/hello-subagent/SKILL.md

@@ -12,7 +12,7 @@ description: 使用子代理执行任务、并行开发、分派工作时使用
 ## 派遣规范
 - 每个子代理获得：tasks.md 中的对应任务 + 方案包中的相关约束（~plan: requirements.md + plan.md；~prd: prd/ 中的相关维度文件 + decisions.md）+ 验证命令；涉及 UI 时，再附 `.helloagents/DESIGN.md`（按当前项目存储模式解析）或其中相关片段
 - 新鲜上下文：不继承主会话历史，避免上下文污染
-- 提示开头标记 [子代理任务]，让子代理跳过 bootstrap 加载
+- 提示开头标记 [子代理任务]，让子代理跳过 HelloAGENTS 外层流程
 - 单一职责：一个子代理只做一件事
 - 只提取子代理需要的上下文，不把整个方案包全部塞给子代理
 

package/skills/hello-ui/SKILL.md

@@ -3,12 +3,12 @@ name: hello-ui
 description: 已进入显式 UI 工作流、全局模式中的 UI 任务、已激活项目的视觉变更、设计系统改造或需要视觉验收时使用；在通用 UI 基线之上补充项目契约执行、设计系统映射与视觉验证。
 ---
 
-本 skill 不是 UI 质量的唯一来源。当前已加载 bootstrap 中的 UI 质量基线负责所有 UI 任务的基础水准；本 skill 在显式 UI 工作流和复杂 UI 任务中，补充更明确的契约执行、实现映射与视觉验收。
+本 skill 不是 UI 质量的唯一来源。当前已加载的 HelloAGENTS UI 质量基线负责所有 UI 任务的基础水准；本 skill 在显式 UI 工作流和复杂 UI 任务中，补充更明确的契约执行、实现映射与视觉验收。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，`DESIGN.md` 与方案包按当前上下文中已注入的项目知识/方案目录解析。
 
 ## 适用边界
 已进入显式 UI 规划/实现/验证路径、全局模式中的 UI 任务，或当前项目已激活且任务涉及整页新建、跨多个组件的视觉重做、设计系统改造、需要截图验收的界面任务时，读取本 skill。
-标准模式未激活项目中的普通 UI 请求，仍只受当前 bootstrap 的 UI 质量基线约束；修复 bug、调整文案、改业务逻辑等不涉及视觉变更的任务，不读取本 skill。在已有设计系统中工作时，保留已建立的模式、结构和视觉语言。
+标准模式未激活项目中的普通 UI 请求，仍只受当前已加载的 HelloAGENTS UI 质量基线约束；修复 bug、调整文案、改业务逻辑等不涉及视觉变更的任务，不读取本 skill。在已有设计系统中工作时，保留已建立的模式、结构和视觉语言。
 
 ## 设计契约优先级
 进入 UI 相关的规划、实现、验证时，按以下顺序做设计决策：
@@ -199,8 +199,8 @@ Hero 区域：
 - [ ] 焦点管理：Tab 顺序合理，模态框焦点困住，关闭后焦点回到触发元素
 - [ ] 可访问性：对比度达标，辅助技术可用
 - [ ] 适配：目标平台上正常使用
-- [ ] 技术现代性：使用的技术方案符合当前已加载 bootstrap 的技术要求；若当前模式未加载质量下限章节，则至少满足技术选型原则且无过时依赖
-- [ ] 未使用当前已加载 bootstrap 明确禁止的过时模式；若当前模式未加载该章节，则至少避免紫色渐变默认配色、白底卡片堆砌、默认字体栈、emoji 图标等已列出的过时模式
+- [ ] 技术现代性：使用的技术方案符合 HelloAGENTS 技术要求；若当前模式未加载质量下限章节，则至少满足技术选型原则且无过时依赖
+- [ ] 未使用当前已加载的 HelloAGENTS 规则明确禁止的过时模式；若当前模式未加载该章节，则至少避免紫色渐变默认配色、白底卡片堆砌、默认字体栈、emoji 图标等已列出的过时模式
 
 ### 设计自评
 对以下维度各打 1-10 分，低于 8 分的维度必须迭代改进：

package/skills/hello-verify/SKILL.md

@@ -48,7 +48,7 @@ description: 声称工作完成前、提交代码前、创建 PR 前、报告任
 - 每次提交应该是一个原子操作：要么全部有意义，要么全部回滚
 
 ### 代码体积检查
-变更涉及的文件必须符合当前已加载 bootstrap 的编码原则中的体积控制规则：
+变更涉及的文件必须符合 HelloAGENTS 编码原则中的体积控制规则：
 - 文件/类 >300 行 → 评估是否需要拆分
 - 文件/类 >400 行 → 必须按职责拆分（例外：生成代码、大型测试夹具、迁移脚本、协议常量表）
 - 函数/方法 >40 行 → 评估是否需要拆分

package/skills/hello-write/SKILL.md

@@ -3,7 +3,7 @@ name: hello-write
 description: 撰写文档、README、技术方案、分析报告、用户指南，或任何需要专业文本产出的任务时使用。
 ---
 
-文本产出先遵守当前 bootstrap 的通用语言规则：简洁、自然、准确、合理、不赘述、不冗余、不过度精简；准确优先于压缩，不写黑话、空话、营销话和无执行价值的客套。
+文本产出按通用语言与表述要求执行；本技能补充结构、表达与格式要求。
 
 文本产出必须遵循以下规范。
 

package/skills/helloagents/SKILL.md

@@ -5,27 +5,26 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 
 # HelloAGENTS
 
-主代理触发或读取任意 skill 时，只有在该条消息是本轮最终收尾消息时，才按当前已加载 bootstrap 规则包装 HelloAGENTS 外层输出格式；任何 skill 若在本轮明确要求输出停顿、确认或总结，对应消息也必须同时满足相同条件。最终收尾中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时按等待输入收尾，已获授权且可继续执行时不得收尾。
-子代理只豁免路由与收尾要求，直接执行任务；安全、质量、验证和失败处理规则仍持续生效，且不得包装 HelloAGENTS 外层输出格式。所有流式内容、进度或状态汇报、中间文本，以及任何仍将继续执行的文本，都不得触发外层格式。
+主代理触发或读取任意 skill 时，只有本轮最终收尾消息才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何仍将继续执行的文本，都保持自然输出。最终收尾中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。
+子代理只豁免路由与收尾要求，直接执行任务；安全、质量、验证和失败处理规则仍持续生效，且不得包装 HelloAGENTS 外层输出格式。
 只有运行时必须识别本轮“完成 / 等待输入 / 阻塞”时，主代理才写 turn-state；普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景：显式 `~auto` / `~loop`、非只读任务完成验证并进入收尾、需要 delivery gate / Ralph Loop / closeout evidence、需要等待或阻塞且运行时必须识别状态、已进入项目连续流程或方案包闭环。首选 `helloagents-turn-state write --kind complete --role main`；等待或阻塞时写 `kind=waiting` / `kind=blocked`，并同时写 `reasonCategory` 与 `reason`。显式 `~auto` / `~loop` 下，还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`。不要查找、读取或拼接 `turn-state.mjs` 源码路径。子代理不得写 turn-state。
 
-`.helloagents/` 在所有 skill 中都统一按项目级存储路径理解：项目本地 `.helloagents/` 继续承担激活信号和会话运行态；状态文件只使用 `state_path`（实际位于 `sessions/{branch}/{session-or-default}/STATE.md`）；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；若 `project_store_mode=repo-shared`，`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析，不要假定这些文件一定实际位于当前工作树中。
+`.helloagents/` 在所有 skill 中都统一按项目级存储路径理解：项目本地 `.helloagents/` 继续承担激活信号和会话运行态；状态文件只使用 `state_path`（实际位于 `sessions/{workspace}/{session}/STATE.md`）；会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`；`sessions/active.json` 只作为当前活跃会话索引；若 `project_store_mode=repo-shared`，`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析，不要假定这些文件一定实际位于当前工作树中。
 
 ## 三重质量保障
 
 以下三重机制按任务类型适用；一旦当前任务进入对应阶段，对应机制就是强制要求，不可跳过或弱化。普通问候、普通问答、T0 只读分析和一次性解释不进入完整实现、验证或收尾流程。
 
 ### 质量标准
-每个 hello-* 技能的规范是强制性的，不是建议。
-技能被激活时，其中的每一条规范都必须遵守。
-违反规范 = 质量不合格，必须修复。
+每个 hello-* 技能的规范都是当前任务进入对应场景后的执行标准。
+技能被激活时，逐条落实；未满足时先修复再交付。
 
 ### 流程纪律（执行时）
-- 执行 command skill 时，公共阶段边界以当前已加载 bootstrap 为准；command skill 只补充该命令的专属动作和边界
+- 执行 command skill 时，公共阶段边界以当前已加载的 HelloAGENTS 规则为准；command skill 只补充该命令的专属动作和边界
 - 统一执行流程的六个阶段（ROUTE/TIER→SPEC→PLAN→BUILD→VERIFY→CONSOLIDATE）按当前 Delivery Tier 和实际任务推进；未进入的阶段不强行补齐，已进入的阶段不可跳过
-- 所有 UI 任务先受当前 bootstrap 的 UI 质量基线约束；已激活项目、全局模式或显式 UI 工作流中的设计约束优先级固定为：当前 `plan.md` / PRD UI 决策 → `.helloagents/DESIGN.md`（按当前项目存储模式解析） → `hello-ui` 具体 UI 审美与实现规则，并与 UI 质量基线共同生效
+- 所有 UI 任务先受当前已加载的 HelloAGENTS UI 质量基线约束；已激活项目、全局模式或显式 UI 工作流中的设计约束优先级固定为：当前 `plan.md` / PRD UI 决策 → `.helloagents/DESIGN.md`（按当前项目存储模式解析） → `hello-ui` 具体 UI 审美与实现规则，并与 UI 质量基线共同生效
 - 方案包存在 `contract.json` 时，验证分流、reviewer / tester 关注边界、可选 style advisor / visual validation 与交付检查优先按它执行，不再从自然语言总结里回推
-- 因阻塞判定而必须等待用户输入时，遵循当前 bootstrap 的等待输入规则，不得把等待输入包装成完成态
+- 因阻塞判定而必须等待用户输入时，按当前已加载的 HelloAGENTS 规则处理，不得把等待输入包装成完成态
 - ~plan 的需求澄清与方案确认不可跳过，不可一个问题就出方案
 - ~prd 的维度探索不可跳过，每个激活维度必须经过讨论或用户明确跳过
 - ~auto 的复杂度判断不可省略
@@ -39,7 +38,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 4. 有未通过项 → 修复后重新检查
 5. 全部通过 → 才能报告完成
 
-未经过完整检查就报告完成 = 违反 HelloAGENTS 核心规则。
+未完成检查时不得报告完成。
 
 ## 技能加载规则（渐进式披露）