@huajiwuyan/hello 3.0.0

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

@@ -0,0 +1,221 @@
+# ~init 命令 - 初始化知识库
+
+本模块定义知识库初始化的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~init
+类型: 场景确认类
+功能: 按照执行流程扫描代码库创建知识库
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~init 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. KB_CREATE_MODE=0 时需用户确认后执行
+4. 知识库已存在时需用户确认重建或升级
+5. 大型项目自动启用分批处理
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 扫描与检测
+
+```yaml
+知识库开关检查:
+  IF KB_CREATE_MODE = 0 (OFF):
+    按G3场景内容规则（确认场景）输出
+    用户选择处理:
+      继续执行: 继续执行下方流程
+      取消: 按 G6 状态重置协议执行，流程终止
+  ELSE (开关=1/2/3):
+    直接继续执行下方流程（无需额外确认）
+```
+
+<kb_status_check>
+知识库状态检测步骤:
+1. 检查 helloagents/ 目录是否存在
+2. 检查核心文件完整性
+3. 对比当前结构与框架标准
+4. 判定处理路径（全新创建/升级/补全/重建）
+</kb_status_check>
+
+```yaml
+检测现有知识库状态:
+  工具使用:
+    - 文件查找: 检查 helloagents/ 目录是否存在
+    - 文件读取: 检查知识库核心文件（INDEX.md, context.md, CHANGELOG.md, modules/_index.md）
+
+  状态判定:
+    不存在: 全新创建
+    存在但结构与当前框架不匹配: 建议升级
+    存在但不完整: 补全缺失文件
+    存在且完整: 询问是否重建
+
+  检测到结构不匹配时:
+    按G3场景内容规则（确认场景）输出
+    用户选择处理:
+      升级: 转发到 references/functions/upgrade.md
+      重建: 继续执行步骤3
+      取消: 按 G6 状态重置协议执行
+
+  重建确认（知识库已存在且完整时）:
+    按G3场景内容规则（确认场景）输出
+```
+
+<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接口（路由文件扫描）
+  - 数据模型（模型文件扫描）
+```
+
+### 步骤3: 创建知识库文件
+
+```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/（空目录，待执行方案包）
+
+大型项目处理:
+  判定条件: 按 G9 "大型项目判定" 条件执行
+  目录结构（模块数>30时）:
+    - helloagents/modules/_index.md（全局索引）
+    - helloagents/modules/core/（核心模块）
+    - helloagents/modules/feature/（功能模块）
+    - helloagents/modules/shared/（共享模块）
+  处理方式:
+    - 分批处理（每批≤20个模块）
+    - 优先处理核心模块
+    - 在总结中说明处理进度
+```
+
+### 步骤4: 后续操作
+
+> 📌 规则引用: 验收标准见 G8 "~init 验收标准"
+
+```yaml
+验证项:
+  完整性:
+    - 核心文件存在且非空
+    - 模块覆盖完整
+  安全性:
+    - 无敏感信息泄露（密钥、密码等）
+  格式:
+    - Markdown格式正确
+    - Mermaid图表可渲染
+
+完成后: 按G3场景内容规则（完成场景）输出初始化结果
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 空项目（无源代码文件） → 按G3场景内容规则（错误场景）输出，建议确认目录
+- 权限不足（无法创建目录） → 按G3场景内容规则（错误场景）输出，建议检查权限
+- 扫描超时（大型项目） → 分批处理，输出进度提示
+- 配置文件缺失（无法识别项目类型） → 询问用户提供技术栈信息
+
+---
+
+## 用户选择处理
+
+### 场景: 知识库开关确认（KB_CREATE_MODE=0）
+
+```yaml
+内容要素:
+  - 当前开关状态: KB_CREATE_MODE = 0 (OFF)
+  - 行为说明: 知识库操作已关闭，~init 将忽略开关强制执行
+
+选项:
+  继续执行: 忽略开关，继续初始化知识库
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 结构不匹配
+
+```yaml
+内容要素:
+  - 检测结果: 知识库存在但结构与当前框架不匹配
+  - 不匹配说明: 具体的结构差异描述
+
+选项:
+  升级: 转发到 references/functions/upgrade.md
+  重建: 删除现有知识库，重新创建
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 知识库重建确认
+
+```yaml
+内容要素:
+  - 已存在说明: 知识库已存在且完整
+  - 重建影响: 将删除现有内容并重新创建
+
+选项:
+  重建: 删除现有知识库，重新创建
+  取消: 按 G6 状态重置协议执行
+```

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

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

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

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