@huajiwuyan/hello 3.0.0

package/templates/claude/skills/references/functions/init.md

@@ -0,0 +1,228 @@
+# ~init 命令 - 初始化知识库
+
+本模块定义知识库初始化的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~init
+类型: 场景确认类
+功能: 扫描代码库创建知识库，根据检测场景展示确认选项
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~init 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. KB_CREATE_MODE=0 时需用户确认后执行
+3. 知识库已存在时需用户确认重建或升级
+4. 大型项目自动启用分批处理
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 知识库开关检查
+
+<kb_switch_analysis>
+知识库开关检查推理过程:
+1. 读取 KB_CREATE_MODE 当前值
+2. 若为 0 (OFF)，提示用户确认是否继续
+3. 若为 1/2/3，直接继续执行
+</kb_switch_analysis>
+
+```yaml
+执行时机: 进入init流程后首先检查
+
+IF KB_CREATE_MODE = 0 (OFF):
+  按 G3 场景内容规则（确认）输出
+
+  用户选择处理:
+    继续执行: 继续执行下方流程
+    取消: 按 G7 状态重置协议执行，流程终止
+
+ELSE (开关=1/2/3):
+  直接继续执行下方流程（无需额外确认）
+```
+
+### 步骤2: 检测现有知识库状态
+
+<kb_status_analysis>
+知识库状态检测推理过程:
+1. 检查 helloagents/ 目录是否存在
+2. 检查核心文件完整性
+3. 对比当前结构与框架标准
+4. 判定处理路径（全新创建/升级/补全/重建）
+</kb_status_analysis>
+
+```yaml
+工具使用:
+  - 文件查找: 检查 helloagents/ 目录是否存在
+  - 文件读取: 检查知识库核心文件（核心文件定义见 references/services/knowledge.md）
+
+状态判定:
+  不存在: 全新创建
+  存在但结构与当前框架不匹配: 建议升级
+  存在但不完整: 补全缺失文件
+  存在且完整: 询问是否重建
+```
+
+**检测到结构不匹配时：** 按 G3 场景内容规则（确认）输出
+
+```yaml
+用户选择处理:
+  升级: 转发到 references/functions/upgrade.md
+  重建: 继续执行步骤3-5
+  取消: 按 G7 状态重置协议执行
+```
+
+**重建确认（知识库已存在且完整时）：** 按 G3 场景内容规则（确认）输出
+
+### 步骤3: 扫描代码库
+
+<techstack_detection>
+技术栈识别推理过程:
+1. 扫描根目录配置文件（package.json, pyproject.toml, pom.xml等）
+2. 分析源代码文件扩展名分布
+3. 检查框架特征文件（如 next.config.js, vite.config.ts）
+4. 综合判断主要语言、框架、包管理器
+5. 如无法确定，标注"未识别"并建议用户补充
+</techstack_detection>
+
+```yaml
+工具使用:
+  - 文件查找: 扫描项目源代码目录结构
+  - 文件读取: 读取关键配置文件
+  - 内容搜索: 识别模块、API、数据模型
+
+技术栈识别策略（语言无关）:
+  识别顺序:
+    1. 扫描根目录的包管理/构建配置文件
+    2. 分析源代码文件扩展名分布
+    3. 检查常见框架特征文件
+  识别优先级:
+    1. 根目录配置文件（最可靠）
+    2. 常见子目录（src/、lib/、app/）
+    3. 文件扩展名统计（兜底）
+  输出要求:
+    - 记录到 context.md 的"技术上下文"章节
+    - 包含: 语言、框架、包管理器、构建工具
+    - 如无法确定，标注"未识别"并建议用户补充
+
+提取信息:
+  - 技术栈（语言、框架、依赖）
+  - 模块结构（目录分析）
+  - API接口（路由文件扫描）
+  - 数据模型（模型文件扫描）
+```
+
+### 步骤4: 创建知识库文件
+
+```yaml
+目录创建规则: 按 G1 "目录/文件自动创建规则" 执行
+
+读取 references/services/templates.md 获取模板，创建:
+  根目录:
+    - helloagents/INDEX.md（知识库入口）
+    - helloagents/context.md（项目上下文）
+    - helloagents/CHANGELOG.md（变更日志）
+
+  modules目录:
+    - helloagents/modules/_index.md（模块索引）
+    - helloagents/modules/{module}.md（每个模块）
+
+  归档目录:
+    - helloagents/archive/_index.md（归档索引）
+    - helloagents/plan/（空目录，待执行方案包）
+
+大型项目处理:
+  判定条件: 按 references/rules/scaling.md 规则判定
+  目录结构（模块数>30时）:
+    - helloagents/modules/_index.md（全局索引）
+    - helloagents/modules/core/（核心模块）
+    - helloagents/modules/feature/（功能模块）
+    - helloagents/modules/shared/（共享模块）
+  处理方式:
+    - 分批处理（每批≤20个模块）
+    - 优先处理核心模块
+    - 在总结中说明处理进度
+```
+
+### 步骤5: 质量验证
+
+> 📌 规则引用: 验收标准见 G9 "~init 验收标准"
+
+```yaml
+验证项:
+  完整性:
+    - 核心文件存在且非空
+    - 模块覆盖完整
+  安全性:
+    - 无敏感信息泄露（密钥、密码等）
+  格式:
+    - Markdown格式正确
+    - Mermaid图表可渲染
+
+完成后: 按 G3 场景内容规则（完成）输出初始化结果
+执行: 按 G7 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 空项目（无源代码文件） → 按 G3 场景内容规则（错误）输出，建议确认目录
+- 权限不足（无法创建目录） → 按 G3 场景内容规则（错误）输出，建议检查权限
+- 扫描超时（大型项目） → 分批处理，输出进度提示
+- 配置文件缺失（无法识别项目类型） → 询问用户提供技术栈信息
+
+---
+
+## 用户选择处理
+
+> 本章节定义 ~init 命令需要用户确认的场景，供 G3 输出格式统一提取。
+
+### 场景: 知识库开关确认（KB_CREATE_MODE=0）
+
+```yaml
+内容要素:
+  - 当前开关状态: KB_CREATE_MODE = 0 (OFF)
+  - 行为说明: 知识库操作已关闭，~init 将忽略开关强制执行
+
+选项:
+  继续执行: 忽略开关，继续初始化知识库
+  取消: 按 G7 状态重置协议执行
+```
+
+### 场景: 结构不匹配
+
+```yaml
+内容要素:
+  - 检测结果: 知识库存在但结构与当前框架不匹配
+  - 不匹配说明: 具体的结构差异描述
+
+选项:
+  升级: 转发到 references/functions/upgrade.md
+  重建: 删除现有知识库，重新创建
+  取消: 按 G7 状态重置协议执行
+```
+
+### 场景: 知识库重建确认
+
+```yaml
+内容要素:
+  - 已存在说明: 知识库已存在且完整
+  - 重建影响: 将删除现有内容并重新创建
+
+选项:
+  重建: 删除现有知识库，重新创建
+  取消: 按 G7 状态重置协议执行
+```

package/templates/claude/skills/references/functions/plan.md

@@ -0,0 +1,219 @@
+# ~plan 命令 - 执行到方案设计
+
+本模块定义规划命令的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~plan [<需求描述>]
+类型: 需求评估类
+功能: 执行到方案设计阶段后停止（不进入开发实施），评估需求完整性后进入方案设计
+模式: WORKFLOW_MODE = AUTO_PLAN
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~plan 模式适配规则:
+1. 本命令固定使用 AUTO_PLAN 模式
+2. 流程在方案设计完成后终止，不进入开发实施
+3. 微调模式需特殊处理（建议直接执行或强制规划）
+4. 静默模式下自动选择推荐方案
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 设置状态变量
+
+```yaml
+执行内容:
+  - WORKFLOW_MODE = AUTO_PLAN
+  - STAGE_ENTRY_MODE = NATURAL
+```
+
+### 步骤2: 需求评估与触发响应
+
+<module_loading>
+本步骤的评估规则定义在 references/stages/evaluate.md 中，
+包含评分维度、追问循环规则、复杂度判定逻辑等具体指导。
+</module_loading>
+
+<requirement_analysis>
+需求评估推理过程:
+1. 解析用户需求描述的完整性
+2. 按 evaluate.md 规则进行评分
+3. 执行追问循环直至需求明确
+4. 判定复杂度等级（微调/轻量迭代/标准开发）
+</requirement_analysis>
+
+```yaml
+执行规则: 读取并执行 references/stages/evaluate.md（评分、追问循环、复杂度判定）
+
+输出: 按 G3 场景内容规则（确认）输出，见"用户选择处理 - 执行模式确认"
+
+[等待用户响应]
+
+用户选择后按对应选项处理
+```
+
+### 步骤3: 执行对应模式
+
+<mode_routing_analysis>
+模式路由推理过程:
+1. 根据复杂度判定结果选择执行路径
+2. 微调模式需特殊处理（建议直接执行）
+3. 轻量迭代/标准开发继续后续步骤
+</mode_routing_analysis>
+
+```yaml
+根据复杂度判定结果:
+  微调模式: 按"微调模式处理"规则输出提示，建议直接执行
+  轻量迭代/标准开发: 进入步骤4
+```
+
+### 步骤4: 项目分析（仅轻量迭代/标准开发）
+
+```yaml
+执行规则: 读取并执行 references/stages/analyze.md
+
+静默模式: 不输出
+交互模式: 输出阶段完成提示
+```
+
+### 步骤5: 方案设计
+
+```yaml
+执行规则: 读取并执行 references/stages/design.md
+
+复杂任务: 静默模式下自动选择推荐方案
+简单任务: 静默模式下自动确定方案
+
+设置: CREATED_PACKAGE = 本次创建的方案包路径
+```
+
+### 步骤6: 流程级验收
+
+```yaml
+执行规则: 按 G9 "流程级验收规则" 执行
+
+验收内容:
+  交付物验收:
+    - 方案包状态: 已创建
+    - 方案包验收: 通过/部分通过
+
+  需求符合性:
+    - 原始需求回顾
+    - 方案覆盖范围
+
+  问题汇总:
+    - 方案包验收警告（如有）
+    - 信息性记录
+
+遗留方案包扫描:
+  执行规则: 按 G7 "遗留方案包扫描" 执行
+  扫描时机: 流程即将结束时
+  显示条件: 检测到≥1个遗留方案包
+  详细规则: 参考 references/rules/package.md "遗留方案包处理"
+
+完成后: 按 G3 场景内容规则（完成）输出规划命令结果（含验收报告）
+执行: 按 G7 状态重置协议执行
+流程终止（不进入开发实施）
+```
+
+---
+
+## 微调模式处理
+
+```yaml
+触发条件: 复杂度判定为微调模式时
+
+执行规则:
+  按 G3 场景内容规则（确认）输出，见"用户选择处理 - 微调模式处理"
+
+  [等待用户响应]
+
+  用户选择后按对应选项处理
+```
+
+---
+
+## 不确定性处理
+
+- 需求描述不完整 → 按 evaluate.md 追问循环处理
+- 复杂度判定为微调 → 提示用户选择直接执行或强制规划
+- 方案设计无法完成 → 输出已完成部分，标注待定项
+
+---
+
+## 用户选择处理
+
+> 本章节定义 ~plan 命令需要用户确认的场景，供 G3 输出格式统一提取。
+
+### 场景: 执行模式确认（需求评估完成后）
+
+```yaml
+触发条件: WORKFLOW_MODE = AUTO_PLAN（~plan命令触发）
+
+内容要素:
+  - 需求评估结果摘要
+  - 复杂度判定结果（微调/轻量迭代/标准开发）
+  - 执行方式说明（静默执行 vs 交互执行的区别）
+  - 预计影响范围
+
+选项:
+  确认执行（静默）: 保持 WORKFLOW_MODE = AUTO_PLAN，静默执行直到方案设计完成
+  交互执行: 设置 WORKFLOW_MODE = INTERACTIVE，切换为交互模式，每阶段确认
+  调整模式: 允许用户选择其他执行模式（微调/轻量迭代/标准开发）
+  取消: 按 G7 状态重置协议执行
+
+状态变更规则:
+  - "确认执行": 保持 AUTO_PLAN 不变
+  - "交互执行": WORKFLOW_MODE → INTERACTIVE（模式切换，详见 references/rules/state.md）
+```
+
+### 场景: 微调模式处理
+
+```yaml
+触发条件: ~plan命令 + 复杂度判定为微调模式
+
+内容要素:
+  - 复杂度判定: 微调模式
+  - 模式说明: 微调模式无需方案设计，~plan命令的目标是生成方案包
+  - 操作选项说明
+
+选项:
+  直接执行:
+    - 说明: 虽然~plan本意是生成方案包，但微调模式可直接执行
+    - 设置: WORKFLOW_MODE = INTERACTIVE（切换为交互模式）
+    - 设置: CURRENT_STAGE = TWEAK
+    - 执行: 读取并执行 references/stages/tweak.md
+    - 完成后: tweak.md 执行状态重置，~plan 流程结束
+  强制规划:
+    - 说明: 升级为轻量迭代，生成方案包
+    - 设置: CURRENT_STAGE = ANALYZE
+    - 执行: 读取并执行 references/stages/analyze.md → design.md
+    - 完成后: 按 plan.md 步骤6流程级验收
+  取消: 按 G7 状态重置协议执行
+
+注意: ~plan命令的微调模式是特殊情况，因为微调不产生方案包
+```
+
+### 场景: 流程级验收完成
+
+```yaml
+内容要素:
+  - 验收状态: 通过/部分通过/失败
+  - 交付物摘要: 方案包路径和状态
+  - 需求符合性: 方案覆盖范围
+  - 问题汇总: 警告和信息性记录（如有）
+
+输出格式: 按 G3 场景内容规则（完成）输出
+```

package/templates/claude/skills/references/functions/review.md

@@ -0,0 +1,146 @@
+# ~review 命令 - 代码审查
+
+本模块定义代码审查的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~review [<路径>]
+类型: 范围选择类
+功能: AI辅助代码审查，必须选择审查范围（全部代码/最近修改/暂存区/指定路径）
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~review 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 无参数时需用户选择审查范围
+3. 审查结果按严重程度分级
+4. 发现问题时提供优化方案选项
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 确定审查范围
+
+```yaml
+执行内容:
+  - 无参数时询问用户选择范围
+  - 支持: 全部代码/最近修改/暂存区/指定路径
+
+按 G3 场景内容规则（确认）输出，见"用户选择处理 - 审查范围选择"
+```
+
+### 步骤2: 代码分析
+
+<code_quality_analysis>
+代码质量分析推理过程:
+1. 评估代码复杂度（函数长度、嵌套层级、圈复杂度）
+2. 检测代码重复度和命名规范一致性
+3. 分析注释覆盖率和文档完整性
+4. 识别不安全函数使用和敏感信息硬编码
+5. 检测注入风险（SQL/命令/XSS）和低效算法模式
+6. 按严重程度分级问题并提供修复建议
+</code_quality_analysis>
+
+```yaml
+质量维度:
+  - 代码复杂度（函数长度、嵌套层级）
+  - 代码重复度
+  - 命名规范一致性
+  - 注释覆盖率
+
+安全维度:
+  - 不安全函数使用
+  - 敏感信息硬编码
+  - 注入风险（SQL/命令/XSS）
+
+性能维度:
+  - 低效算法模式
+  - 资源泄漏风险
+```
+
+### 步骤3: 生成报告
+
+```yaml
+执行内容:
+  - 按严重程度分级（Critical/Warning/Info）
+  - 提供文件路径、行号、修复建议
+```
+
+### 步骤4: 后续操作
+
+```yaml
+有问题时:
+  按 G3 场景内容规则（确认）输出，见"用户选择处理 - 代码审查结果处理"
+  [等待用户响应]
+  用户选择后按对应选项处理
+
+目录/文件创建: 按 G1 "目录/文件自动创建规则" 执行
+
+完成后: 按 G7 状态重置协议执行
+```
+
+---
+
+## 分析原则
+
+```yaml
+审查策略:
+  - 测试文件降低安全检查严格度
+  - 生成的代码/压缩代码跳过审查
+  - 框架特定代码参考框架最佳实践
+  - 复杂度难以判定时标注"需人工审查"
+```
+
+---
+
+## 不确定性处理
+
+- 文件类型无法识别 → 跳过审查，标注"未知类型"
+- 复杂度难以判定 → 标注"需人工审查"
+- 审查范围过大 → 建议缩小范围或分批审查
+
+---
+
+## 用户选择处理
+
+> 本章节定义 ~review 命令需要用户确认的场景，供 G3 输出格式统一提取。
+
+### 场景: 审查范围选择（无参数时）
+
+```yaml
+内容要素:
+  - 可选审查范围: 全部代码/最近修改/暂存区/指定路径
+  - 各范围的说明和适用场景
+
+选项:
+  全部代码: 审查整个代码库
+  最近修改: 仅审查最近修改的文件
+  暂存区: 仅审查 Git 暂存区的文件
+  指定路径: 用户输入具体路径
+  取消: 按 G7 状态重置协议执行
+```
+
+### 场景: 代码审查结果处理
+
+```yaml
+内容要素:
+  - 审查结果摘要（按严重程度分级）
+  - 问题列表（Critical/Warning/Info）
+  - 关键问题的文件路径和行号
+
+选项:
+  生成优化方案: 创建 plan/YYYYMMDDHHMM_code-review/ 方案包
+  仅记录报告: 输出完整报告
+  跳过: 不执行操作
+```