@huajiwuyan/hello 3.0.0

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

@@ -0,0 +1,190 @@
+# ~rollback 命令 - 智能回滚
+
+本模块定义回滚操作的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~rollback
+类型: 目标选择类
+功能: 按照执行流程回滚变更，可选择回滚目标（版本/提交），触发 EHRB 时按 G2 处理流程执行
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~rollback 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. 回滚前必须创建备份
+4. EHRB 检测始终生效
+5. 必须用户确认回滚目标
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 扫描回滚来源
+
+<rollback_source_check>
+回滚来源分析步骤:
+1. 检测项目是否使用Git且有提交历史
+2. 检查archive/中是否存在可回滚的方案包
+3. 分析CHANGELOG.md中的版本历史记录
+4. 确定最佳回滚来源（优先Git，备选方案包/CHANGELOG）
+</rollback_source_check>
+
+<rollback_impact_assessment>
+回滚影响评估步骤:
+1. 分析目标版本与当前版本的差异
+2. 识别将被覆盖的文件和变更
+3. 评估回滚对依赖模块的影响
+4. 按 G2 EHRB 检测规则判定是否涉及高风险操作
+</rollback_impact_assessment>
+
+```yaml
+前置条件（满足任一）:
+  - 项目使用 Git 且有提交历史
+  - archive/ 中存在可回滚的方案包
+  - CHANGELOG.md 记录了版本历史
+
+执行内容:
+  - 优先使用 Git 历史，备选: 方案包历史、CHANGELOG
+  - 最多显示5个版本，显示变更摘要和文件数
+  - 警告回滚影响
+
+按G3场景内容规则（确认场景）输出，见"用户选择处理 - 回滚版本选择"
+```
+
+### 步骤3: 执行回滚
+
+```yaml
+创建备份:
+  Git仓库: 创建备份分支
+  非Git: 复制文件到 backup/
+
+执行回滚:
+  - 恢复代码文件
+  - 验证恢复结果
+
+同步知识库:
+  读取 KB_CREATE_MODE
+  CHANGELOG更新:
+    - 添加回滚记录
+    - 记录格式:
+        ### 回滚
+        - **[{模块名}]**: 回滚至 {版本/提交}
+          - 原因: {回滚原因}
+          - 方案: [{原方案包}](archive/{YYYY-MM}/{原方案包}/)
+    - 目录/文件创建: 按 G1 "目录/文件自动创建规则" 执行
+  其他KB操作: 按 G1 "KB开关检查规则" 执行
+    - 说明: 回滚操作始终视为编程任务，KB_CREATE_MODE=2 时按编程任务处理
+```
+
+### 步骤4: 后续操作
+
+```yaml
+执行规则: 按 G8 命令级验收标准（~rollback）执行
+
+验收项:
+  - 代码状态与目标版本一致 (阻断性): git status 无意外变更
+  - 目标提交正确 (阻断性): git log 确认当前提交为目标版本
+  - 知识库状态一致 (警告性，如适用): CHANGELOG 已更新
+
+验收方式:
+  - 执行 git status 确认无意外变更
+  - 执行 git log -1 确认当前提交正确
+
+验收失败处理:
+  阻断性失败:
+    - 按G3场景内容规则（警告场景）输出
+    - 提示用户检查备份并手动恢复
+  警告性失败:
+    - 记录到回滚报告
+    - 继续完成流程
+
+完成后: 按G3场景内容规则（完成场景）输出回滚结果（含验收报告）
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 安全约束
+
+> 📌 规则引用: 按 G2 EHRB 检测规则执行
+
+```yaml
+强制约束:
+  - 回滚前必须创建备份
+  - EHRB 检测: 按 G2 EHRB 检测规则执行（生产环境、破坏性操作、不可逆操作等）
+  - EHRB 处理: 按 G2 EHRB 处理流程执行
+```
+
+---
+
+## 不确定性处理
+
+- 无Git历史 → 使用方案包历史
+- 全部不可用 → 输出错误，建议手动处理
+- 回滚冲突 → 列出冲突文件，询问用户决定
+
+---
+
+## 用户选择处理
+
+### 场景: 回滚版本选择
+
+```yaml
+内容要素:
+  - 可回滚版本: 版本列表（最多5个），包含变更摘要和文件数
+  - 回滚来源: 当前使用的回滚来源（Git/方案包/CHANGELOG）
+  - 当前状态: 当前版本信息
+
+选项:
+  选择版本N: 选择对应序号的版本进行回滚
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 回滚确认（EHRB警告）
+
+> 当 G2 EHRB 检测规则触发时显示此场景
+
+```yaml
+内容要素:
+  - 目标版本: 将回滚到的版本信息
+  - 影响范围: 将被覆盖的文件列表和变更内容
+  - 风险说明: 按G3场景内容规则（警告场景）格式（风险类型、影响范围、风险等级、检测依据）
+  - 备份策略: 将创建的备份方式（分支/文件复制）
+
+选项:
+  确认回滚: 创建备份并执行回滚（按 G2 记录到 CHANGELOG）
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 回滚冲突处理
+
+```yaml
+内容要素:
+  - 冲突文件: 发生冲突的文件列表
+  - 冲突详情: 每个文件的冲突内容摘要
+  - 处理建议: 推荐的冲突解决方式
+
+选项:
+  覆盖本地: 使用目标版本覆盖当前文件
+  保留本地: 保留当前文件，跳过冲突项
+  手动处理: 暂停回滚，用户手动解决冲突
+  取消: 中止回滚，按 G6 状态重置协议执行
+```

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

@@ -0,0 +1,140 @@
+# ~test 命令 - 运行测试
+
+本模块定义运行测试的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~test
+类型: 场景确认类
+功能: 按照执行流程检测框架运行测试并分析结果
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~test 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. 自动检测测试框架，多框架时需用户选择
+4. 无法检测时请求用户提供测试命令
+5. 测试失败时提供修复方案选项
+6. 需要设计新测试用例时自动调用 tester 子代理（按 G9/G10 规则）
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 扫描测试环境
+
+```yaml
+执行内容:
+  - 扫描项目配置文件识别测试框架
+  - 扫描常见测试目录和文件
+  - 匹配测试文件命名模式
+
+多框架共存时: 询问用户选择
+无法检测时: 请求用户提供测试命令
+
+按G3场景内容规则（确认场景）输出
+```
+
+### 步骤3: 执行测试
+
+<test_result_check>
+测试结果分析步骤:
+1. 解析测试输出获取通过/失败/跳过统计
+2. 提取失败测试的文件路径和行号
+3. 分析错误信息确定失败原因
+4. 判断是否为阻断性测试失败
+5. 生成修复建议
+</test_result_check>
+
+```yaml
+执行内容:
+  - 执行测试命令（带超时保护）
+  - 捕获输出和退出码
+  - 解析通过/失败/跳过统计
+  - 提取失败测试的文件路径和行号
+  - 提取错误摘要
+
+输出: 按 Shell 包装规则输出结果
+```
+
+### 步骤4: 后续操作
+
+```yaml
+输出: 按 Shell 包装规则输出结果
+
+有失败时: 按G3场景内容规则（确认场景）输出，见"用户选择处理 - 测试失败处理"
+
+目录/文件创建: 按 G1 "目录/文件自动创建规则" 执行
+
+完成后: 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 无法检测框架 → 询问用户提供测试命令
+- 多框架共存 → 列出选项请用户选择
+- 测试超时 → 询问是否延长或终止
+- 输出无法解析 → 返回原始输出，建议手动分析
+
+---
+
+## 用户选择处理
+
+### 场景: 测试框架选择（多框架共存时）
+
+```yaml
+内容要素:
+  - 检测到的框架列表
+  - 各框架的测试文件数量和位置
+  - 推荐选择（根据项目主要框架）
+
+选项:
+  选择框架N: 使用对应序号的框架运行测试
+  全部运行: 依次运行所有框架的测试
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 无法检测框架
+
+```yaml
+内容要素:
+  - 检测结果: 无法自动识别测试框架
+  - 请求用户提供测试命令
+
+选项:
+  用户输入测试命令: 使用用户提供的命令运行测试
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 测试失败处理
+
+```yaml
+内容要素:
+  - 测试结果摘要（通过/失败/跳过统计）
+  - 失败测试列表（文件路径、行号、错误摘要）
+  - 修复建议
+
+选项:
+  生成修复方案: 创建 plan/YYYYMMDDHHMM_fix-tests/ 方案包
+  仅记录报告: 输出完整报告
+  跳过: 不执行操作
+```

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

@@ -0,0 +1,363 @@
+# ~upgrade 命令 - 升级知识库
+
+本模块定义 AI 驱动的知识库升级流程。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~upgrade
+类型: 场景确认类
+功能: 按照执行流程升级知识库结构至最新框架标准
+特点: AI 分析内容语义，动态匹配模板，支持任意源格式
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~upgrade 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. KB_CREATE_MODE=0 时需用户确认后执行
+4. 升级前强制备份，确保可恢复
+5. AI 负责内容分析，脚本负责文件操作
+</mode_adaptation>
+
+---
+
+## 设计原则
+
+```yaml
+职责分离:
+  AI 负责:
+    - 读取模板理解目标结构
+    - 分析源文件内容语义
+    - 识别内容类型（项目概述、需求、方案、技术设计等）
+    - 决定源内容到模板章节的映射关系
+    - 按模板格式生成目标内容
+
+  脚本负责:
+    - 扫描目录列出文件（--scan）
+    - 创建标准目录结构（--init）
+    - 备份现有知识库（--backup）
+    - 按 AI 生成的计划写入文件（--write）
+
+关键约束:
+  - 脚本不做任何内容分析和格式转换
+  - 模板文件是唯一权威来源（SSOT）
+  - AI 通过读取模板动态理解目标格式
+```
+
+---
+
+## 执行流程
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 扫描与分析
+
+```yaml
+知识库开关检查:
+  IF KB_CREATE_MODE = 0 (OFF):
+    按G3场景内容规则（确认场景）输出
+    用户选择处理:
+      继续执行: 继续执行下方流程
+      取消: 按 G6 状态重置协议执行，流程终止
+  ELSE (开关=1/2/3):
+    直接继续执行下方流程（无需额外确认）
+
+读取模板文件:
+  读取以下模板文件，理解目标结构和格式:
+    - {TEMPLATE_DIR}/INDEX.md
+    - {TEMPLATE_DIR}/context.md
+    - {TEMPLATE_DIR}/CHANGELOG.md
+    - {TEMPLATE_DIR}/modules/_index.md
+    - {TEMPLATE_DIR}/archive/_index.md
+    - {TEMPLATE_DIR}/plan/proposal.md
+    - {TEMPLATE_DIR}/plan/tasks.md
+
+扫描知识库:
+  脚本调用: upgradewiki.py --scan
+  获取: 知识库目录结构和文件列表（JSON格式）
+```
+
+<upgrade_content_check>
+AI 内容分析步骤:
+
+1. 读取源文件内容
+   - 对扫描结果中的每个 Markdown 文件，读取其内容
+   - 跳过明显的非知识库文件（如 .gitignore、node_modules 等）
+
+2. 识别内容类型
+   - 项目概述类：项目介绍、背景、目标、技术栈
+   - 需求类：功能需求、业务需求、用户故事
+   - 方案类：设计方案、架构方案、技术方案
+   - 技术设计类：详细设计、接口设计、数据模型
+   - 变更记录类：更新日志、版本记录
+   - 模块文档类：功能模块说明、API文档
+   - 方案包类：符合 YYYYMMDDHHMM_feature 命名的目录
+
+3. 分析映射关系
+   - 将识别的内容类型映射到目标模板的对应章节
+   - 处理内容合并（多个源文件 → 一个目标文件）
+   - 处理内容拆分（一个源文件 → 多个目标文件）
+
+4. 生成升级计划
+   - 列出所有需要的操作（创建、合并、重命名、删除）
+   - 标注每个操作的源内容和目标位置
+   - 评估风险和注意事项
+</upgrade_content_check>
+
+```yaml
+展示升级计划:
+  按G3场景内容规则（确认场景）输出
+
+  内容要素:
+    - 源文件分析结果（识别到的内容类型）
+    - 升级计划（操作列表）
+    - 注意事项（需要人工确认的内容）
+
+  选项:
+    执行升级: 继续执行步骤3
+    查看详情: 展示更多细节后再确认
+    取消: 按 G6 状态重置协议执行
+```
+
+### 步骤3: 执行升级
+
+```yaml
+备份:
+  脚本调用: upgradewiki.py --backup
+  确保: 备份成功后再继续
+
+创建目录结构:
+  脚本调用: upgradewiki.py --init
+  创建: modules/, archive/, plan/ 目录
+
+AI 生成目标内容:
+  根据升级计划，AI 执行以下操作:
+    - 读取源文件内容
+    - 按模板格式重新组织内容
+    - 填充模板占位符
+    - 生成目标文件内容
+
+写入文件:
+  方式A - 直接使用 Write 工具:
+    AI 使用 Write 工具直接写入每个目标文件
+
+  方式B - 批量写入（大量文件时）:
+    1. AI 生成操作计划 JSON 文件
+    2. 脚本调用: upgradewiki.py --write plan.json
+    3. 检查执行结果
+
+清理（可选）:
+  用户确认后，删除已迁移的源文件
+```
+
+### 步骤4: 后续操作
+
+```yaml
+执行规则: 按 G8 命令级验收标准（~upgrade）执行
+
+验收项:
+  - 知识库结构符合目标版本 (阻断性)
+  - 核心文件完整 (阻断性): INDEX.md, context.md 存在且非空
+  - 内容无丢失 (警告性): 对比源文件和目标文件内容
+
+验收方式:
+  调用 ~validate 仅知识库模式，检查验收结果
+
+验收失败处理:
+  阻断性失败:
+    - 按G3场景内容规则（警告场景）输出
+    - 建议用户从备份恢复
+  警告性失败:
+    - 记录到升级报告
+    - 提示用户检查相关内容
+
+完成后: 按G3场景内容规则（完成场景）输出升级结果（含验收报告）
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 安全约束
+
+> 📌 规则引用: 按 G2 EHRB 检测规则执行
+
+```yaml
+强制约束:
+  - 仅操作 helloagents/ 目录
+  - 执行前必须备份
+  - 冲突时不覆盖（报错并请求用户决策）
+  - 不删除未识别的文件（保留原位置）
+
+备份机制:
+  位置: 项目根目录/helloagents_backup_{YYYYMMDDHHMMSS}/
+  内容: 完整的 helloagents/ 目录副本
+  用途: 升级失败时可手动恢复
+```
+
+---
+
+## 内容映射规则
+
+> AI 应根据以下指导原则进行内容映射，而非硬编码规则。
+
+### 映射指导
+
+```yaml
+项目信息 → context.md:
+  识别特征: 项目名称、项目介绍、技术栈、团队信息、开发规范
+  模板位置: 对应 context.md 模板的各章节
+
+变更记录 → CHANGELOG.md:
+  识别特征: 版本号、日期、变更内容、更新日志
+  模板位置: 对应 CHANGELOG.md 模板格式
+
+模块文档 → modules/:
+  识别特征: 功能模块说明、API文档、组件文档
+  模板位置: 按模块创建独立文件
+
+方案包 → plan/ 或 archive/:
+  识别特征: YYYYMMDDHHMM_feature 命名格式
+  文件映射:
+    - why.md + how.md → proposal.md
+    - task.md → tasks.md
+  位置判断:
+    - 未完成的方案包 → plan/
+    - 已完成的方案包 → archive/YYYY-MM/
+```
+
+### 目录结构映射
+
+```yaml
+常见旧结构:
+  wiki/ → modules/
+  history/ → archive/
+  project.md → context.md
+
+判断依据:
+  - 目录内容类型（文档类 vs 归档类）
+  - 文件命名模式
+  - 内容语义分析
+```
+
+---
+
+## 不确定性处理
+
+- 源文件格式无法识别 → 保留原位置，标注"需人工处理"
+- 内容映射冲突 → 请求用户决策
+- 备份失败 → 中止升级，提示用户检查磁盘空间
+
+---
+
+## 脚本参考
+
+> 📌 规则引用: 脚本路径、存在性检查、错误恢复规则见 references/rules/tools.md
+
+### 脚本命令
+
+```yaml
+扫描目录:
+  命令: upgradewiki.py --scan
+  输出: JSON 格式的文件列表和目录结构
+  用途: 获取知识库当前状态
+
+创建目录:
+  命令: upgradewiki.py --init
+  输出: 创建结果（created/existed 列表）
+  用途: 初始化标准目录结构
+
+备份知识库:
+  命令: upgradewiki.py --backup
+  输出: 备份结果（成功/失败，备份路径）
+  用途: 升级前备份
+
+批量写入:
+  命令: upgradewiki.py --write <plan.json>
+  输入: JSON 格式的操作计划
+  输出: 执行结果（成功的操作/错误列表）
+  用途: 批量执行文件操作
+```
+
+### 写入计划格式
+
+```json
+{
+  "operations": [
+    {"action": "write", "path": "context.md", "content": "..."},
+    {"action": "rename", "from": "old.md", "to": "new.md"},
+    {"action": "delete", "path": "obsolete.md"},
+    {"action": "mkdir", "path": "subdir"}
+  ]
+}
+```
+
+---
+
+## 用户选择处理
+
+### 场景: 知识库开关确认（KB_CREATE_MODE=0）
+
+```yaml
+内容要素:
+  - 当前开关状态: KB_CREATE_MODE = 0 (OFF)
+  - 行为说明: 知识库操作已关闭，~upgrade 将忽略开关强制执行
+
+选项:
+  继续执行: 忽略开关，继续升级知识库
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 升级计划确认
+
+```yaml
+内容要素:
+  - 源文件分析: 识别到的文件及其内容类型
+  - 升级计划: 需要执行的操作列表
+  - 注意事项: AI 无法自动处理的内容（需人工确认）
+
+选项:
+  执行升级: 备份后执行升级
+  查看详情: 展示具体的内容映射关系
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 升级后验收完成
+
+```yaml
+内容要素:
+  - 验收状态: 通过/部分通过/失败
+  - 结构验收: 目录结构和核心文件状态
+  - 内容验收: 内容迁移完整性
+  - 问题汇总: 警告和建议（如有）
+  - 备份路径: 可用于恢复的备份位置
+
+输出格式: 按G3场景内容规则（完成场景）输出
+```
+
+### 场景: 升级验收失败
+
+```yaml
+内容要素:
+  - 验收结果: 失败项列表
+  - 问题详情: 各失败项的具体问题描述
+  - 备份路径: 可用于恢复的备份位置
+  - 恢复建议: 如何使用备份恢复
+
+选项:
+  从备份恢复: 使用备份恢复到升级前状态
+  忽略继续: 接受当前状态（仅警告性失败时可用）
+  手动修复: 用户手动处理问题
+```