helloagents 3.0.2-beta.1 → 3.0.7

package/skills/commands/design/SKILL.md

@@ -1,108 +0,0 @@
----
-name: ~design
-description: 深度设计工作流 — 交互式需求挖掘、方案设计和执行（~design 命令）
-policy:
-  allow_implicit_invocation: false
----
-Trigger: ~design [description]
-
-~design 覆盖统一执行流程的 ORIENT、CLARIFY 和 PLAN 阶段（上下文收集+深度需求挖掘+方案设计），执行阶段进入统一执行流程。
-
-## 铁律
-- 在用户确认方案之前，禁止编写任何实现代码、创建任何文件、或执行任何实现操作。
-- "这个太简单不需要设计" → 简单项目设计也简单，跳过设计的项目返工更多。
-- 需求挖掘阶段不读取实现类技能（hello-ui/hello-test/hello-verify 等），需求明确后再按需读取。
-
-## 流程
-
-### 1. 上下文收集（ORIENT）
-
-已有项目：
-- 读取 .helloagents/context.md 获取项目上下文和模块索引
-- 读取 .helloagents/guidelines.md 获取项目约定
-- 扫描相关代码文件理解现有架构
-
-全新项目（无 .helloagents/ 目录）：
-- 跳过，直接进入需求挖掘
-
-### 2. 需求挖掘（CLARIFY，交互式，核心阶段）
-
-目标：通过自然对话理解用户想要什么，聚焦三个方向——目的（为什么做、给谁用）、约束（平台、技术、时间）、成功标准（做到什么程度算完成）。
-
-根据项目类型选择挖掘模式：
-
-**假设模式**（已有代码库的项目，优先使用）：
-a. 先读取 5-15 个相关代码文件，理解现有架构和模式
-b. 基于代码证据形成假设列表，每个假设标注置信度（高/中/低）
-c. 向用户展示假设，请求确认/修正（通常 2-4 轮即可完成）
-d. 低置信度假设必须明确询问，高置信度假设可批量确认
-
-**交互模式**（全新项目，或假设模式信息不足时）：
-a. 理解用户的初始描述，识别已知和缺失信息
-b. 每次只问一个问题，偏好选择题，根据回答动态决定下一个问题
-c. 只问影响整体方向的决策，实现细节由 AI 自主决策
-d. 每个问题给出推荐选择和理由，让用户快速决策
-e. 每确认一个决策点就总结已确认内容
-f. 当目的、约束、成功标准都已明确，输出完整需求摘要，请用户确认
-
-选项质量要求：
-- 涉及视觉/交互/体验的问题时，选项必须体现当前前沿设计水准；若当前已加载 bootstrap 含审美/体验规则则遵循其要求，否则至少给出具体、可执行、非泛化的视觉特征
-- 不确定当前前沿趋势时，主动搜索查阅最新设计案例和技术能力后再给出选项
-- 每个选项必须包含具体的视觉特征描述，不接受泛化标签
-
-大项目检测：如果任务描述涉及多个独立子系统，先帮用户分解为子项目，每个子项目走独立的设计→计划→实施循环。
-
-用户说"就这样"或"开始设计"时，进入下一阶段。
-
-### 3. 方案探索（PLAN）
-
-基于已确认的完整需求，提出 2-3 个可行方案：
-- 每个方案简要描述架构思路和关键取舍
-- 标注推荐方案及推荐理由
-- 让用户选择或提出自己的想法
-
-涉及 UI 的方案：此时读取 hello-ui SKILL.md 获取设计规范。
-
-### 4. 方案细化
-
-用户选定方案后，一次性展示完整设计（按复杂度缩放篇幅：简单项目几段话，复杂项目详细展开）：
-- 架构与文件结构
-- 涉及 UI 时：按 hello-ui 的设计思维规范展开
-- 数据流与错误处理
-- 测试策略
-
-展示完成后集中收敛反馈；仅在方案仍未确认时收集一次性修改意见，不逐段停顿。
-
-### 5. 写入方案包
-
-将确认的方案写入本地项目：
-- 全新项目（无 .helloagents/ 目录）：先创建 .helloagents/ 和 STATE.md（按 templates/STATE.md 格式）。这是方案包写入的前置操作，不受 kb_create_mode 开关控制（方案包是流程状态，不是知识沉淀）
-- 创建 .helloagents/plans/YYYYMMDDHHMM_{feature}/
-- 按 templates/plans/ 的模板格式写入 requirements.md、design.md、tasks.md
-- 涉及 UI 的项目：生成或更新 .helloagents/DESIGN.md
-- 重写 .helloagents/STATE.md（正在做什么、关键上下文含已确认的需求摘要、下一步设为"处理方案反馈或进入执行决策"、方案路径）
-
-知识库的完整创建和方案包归档由当前已加载 bootstrap 中的 VALIDATE 规则统一管理。
-
-### 6. 执行决策
-
-展示方案摘要后，仅在是否进入执行仍构成阻塞决策时才询问用户：
-- 开始执行 → 重写 STATE.md（正在做什么、关键上下文、下一步设为第一个任务的具体动作）
-- 修改方案
-- 暂不执行，保留方案 → 重写 STATE.md（下一步设为"方案已确认；执行需用户明确启动"）
-
-如果用户已对当前方案或继续执行作出明确同意，视为执行授权成立，直接进入执行，不再追加确认环节。
-
-### 7. 执行
-
-按 tasks.md 逐项完成，每项进入当前已加载 bootstrap 中定义的统一执行流程，完成后同步重写 STATE.md。任务状态标记仅写入 tasks.md、验收清单或验证结果；普通说明、方案解释、状态汇报不用 [√] / [-] / [ ]。
-所有任务完成后进入当前已加载 bootstrap 中定义的 VALIDATE 阶段。
-可并行的任务标记后用子代理并行执行（不同子代理不改同一文件）。
-执行过程中遇到阻塞（依赖缺失、指令不清、验证反复失败）→ 立即停下询问用户，不猜测。
-执行过程中遇到高风险操作（删除文件/修改配置/数据库变更）→ 暂停确认。
-
-任务分解原则：
-- 每个任务是一个原子操作（单一关注点，可独立完成和验证）
-- 每个任务包含：具体文件路径、预期变更、验证方式
-- 每个任务独立可验证
-- 任务之间有明确的依赖顺序

package/skills/commands/review/SKILL.md

@@ -1,16 +0,0 @@
----
-name: ~review
-description: 代码审查 + 质量检查（~review 命令）
-policy:
-  allow_implicit_invocation: false
----
-Trigger: ~review [scope]
-
-## 流程
-
-1. 获取变更范围：
-   - 无参数：git diff（未提交的变更）
-   - 指定文件/目录：只审查指定范围
-   - "staged"：git diff --staged
-2. 按 hello-* 技能查找路径读取 hello-review SKILL.md，按其审查规范逐文件审查
-3. 按严重度分类输出结果，给出具体修复建议

package/templates/plans/design.md

@@ -1,14 +0,0 @@
-# {项目/功能名称} — 方案设计
-
-## 架构决策
-[关键决策及理由]
-
-## 文件结构
-[涉及的文件和目录规划]
-
-## 视觉设计
-[涉及 UI 时填写：美学方向/配色/字体/布局/记忆点/动效/约束定义/内容策略]
-
-## 决策记录
-[设计过程中的关键决策，供回溯]
-- [YYYY-MM-DD] 决策内容及理由