@huajiwuyan/hello 3.0.0

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

@@ -0,0 +1,275 @@
+# ~brain 命令 - 头脑风暴
+
+本模块定义头脑风暴命令的执行规则，将想法转化为可执行的方案包。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~brain [<主题描述>]
+类型: 场景确认类（简化入口）
+功能: 协作式头脑风暴，通过一问一答澄清需求，探索方案，生成方案包
+触发: 用户输入包含 ~brain
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~brain 模式适配规则:
+1. 本命令为场景确认类，但采用简化入口（无轻量评估确认步骤）
+2. 用户输入 ~brain 后直接进入上下文收集和需求澄清流程
+3. 输出方案包后保持待命状态
+4. 不设置 WORKFLOW_MODE，保持 INTERACTIVE 默认模式
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 上下文收集
+
+```yaml
+执行内容:
+  - 扫描项目结构（目录、主要文件）
+  - 查看相关文件（如用户提供了主题描述，定位相关代码）
+  - 检查最近提交（git log -5）
+
+输出格式:
+  🔵【HelloAGENTS】- ~brain 上下文收集
+  {项目结构摘要、相关文件、最近提交}
+  🔄 下一步: 开始需求澄清
+```
+
+### 步骤2: 需求澄清
+
+```yaml
+执行内容:
+  - 一次一问，每条消息只问一个问题
+  - 优先使用多选题（2-4个选项），开放式问题为辅
+  - 聚焦理解：目的、约束、成功标准
+  - 持续澄清直到充分理解需求（无轮数限制）
+
+输出格式:
+  ❓【HelloAGENTS】- ~brain 需求澄清
+  {单个问题}
+
+  选项:
+    A. {选项1}（推荐）
+    B. {选项2}
+    C. {选项3}
+
+  🔄 下一步: 请选择或输入
+
+问题设计原则:
+  - 从宏观到具体：先确定整体方向，再深入细节
+  - 选项互斥：每个选项代表不同的实现路径
+  - 推荐标注：在推荐选项后标注"（推荐）"并说明理由
+```
+
+### 步骤3: 方案探索
+
+```yaml
+执行内容:
+  - 提出 2-3 个不同方案
+  - 说明每个方案的权衡（优点/缺点）
+  - 给出推荐方案及理由
+
+输出格式:
+  💡【HelloAGENTS】- ~brain 方案探索
+
+  **方案对比:**
+
+  | 方案 | 描述 | 优点 | 缺点 |
+  |------|------|------|------|
+  | A（推荐） | ... | ... | ... |
+  | B | ... | ... | ... |
+  | C | ... | ... | ... |
+
+  **推荐理由:** {为什么推荐方案A}
+
+  🔄 下一步: 请选择方案
+```
+
+### 步骤4: 设计呈现
+
+```yaml
+执行内容:
+  - 将设计分段呈现（每段 200-300 字）
+  - 每段完成后询问确认
+  - 覆盖内容：架构、组件、数据流、错误处理、测试策略
+  - 如用户提出调整，回退修改后重新呈现
+
+输出格式:
+  🔵【HelloAGENTS】- ~brain 设计呈现 (N/M)
+
+  ### {当前段落标题}
+
+  {当前段落内容，200-300字}
+
+  🔄 下一步: 确认继续 / 需要调整
+
+设计段落划分（参考）:
+  1. 整体架构与模块划分
+  2. 核心组件设计
+  3. 数据流与接口定义
+  4. 错误处理与边界情况
+  5. 测试策略与验收标准
+```
+
+### 步骤5: 方案包生成
+
+> 📌 规则引用: 方案包格式与 templates.md 保持一致，确保 ~exec 可正常执行
+
+```yaml
+执行内容:
+  - 创建方案包目录: plan/YYYYMMDDHHMM_<topic>/
+  - 生成 proposal.md（按标准格式，融合头脑风暴内容）
+  - 生成 tasks.md（按标准格式，包含完整任务列表）
+
+proposal.md 结构（与 templates.md 一致）:
+  元信息（必须）:
+    <!--
+    @name: {方案包名称}
+    @created: {YYYY-MM-DD HH:MM}
+    @type: implementation | overview
+    @source: brain
+    -->
+
+  1. 需求（必须）:
+    - 1.1 背景: 需求澄清过程中收集的背景信息
+    - 1.2 目标: 用户想要实现的目标
+    - 1.3 约束条件: 限制和要求
+    - 1.4 验收标准: 如何验证完成
+
+  2. 方案（必须）:
+    - 2.1 方案对比: 方案探索阶段的对比表（~brain 特色）
+    - 2.2 选中方案: 最终选择的方案及理由
+    - 2.3 影响范围: 涉及的模块/文件
+    - 2.4 风险评估: 潜在风险
+
+  3. 技术设计（必须，~brain 设计呈现内容）:
+    - 3.1 架构设计: 整体架构与模块划分
+    - 3.2 核心组件: 组件设计与职责
+    - 3.3 数据流与接口: 接口定义与数据流向
+    - 3.4 错误处理: 边界情况与异常处理
+
+  4. 核心场景（可选）
+
+  5. 技术决策（可选）
+
+  6. 后续建议（~brain 特色）:
+    - 实现注意事项
+    - 测试策略建议
+
+tasks.md 结构（与 templates.md 一致）:
+  元数据头部（必须）:
+    <!--
+    @feature: {功能名称}
+    @created: {YYYY-MM-DD HH:MM}
+    @status: pending
+    @mode: standard | lightweight
+    @source: brain
+    -->
+
+  进度概览（必须）:
+    | 状态 | 数量 |
+    |------|------|
+    | [√] 完成 | 0 |
+    | [X] 失败 | 0 |
+    | [-] 跳过 | 0 |
+    | [ ] 待执行 | N |
+
+  任务列表（必须）:
+    按阶段/模块分组，从设计呈现内容提取具体任务
+
+  执行日志（必须）:
+    初始为空，执行时填充
+
+  执行备注（必须）:
+    记录头脑风暴过程中的特殊说明
+
+输出格式:
+  ✅【HelloAGENTS】- ~brain 完成
+
+  📁 文件变更:
+    - plan/YYYYMMDDHHMM_<topic>/proposal.md
+    - plan/YYYYMMDDHHMM_<topic>/tasks.md
+
+  🔄 下一步: 使用 ~exec 执行方案包
+```
+
+### 步骤6: CHANGELOG 更新
+
+```yaml
+执行内容:
+  - 记录到 CHANGELOG.md "方案设计" 分类
+  - 格式: "- 完成 <topic> 头脑风暴设计"
+
+目录创建: 按 G1 "目录/文件自动创建规则" 执行
+```
+
+---
+
+## 核心原则
+
+```yaml
+单次单问: 每条消息只问一个问题，避免信息过载
+多选优先: 能用选项就不用开放式问题，降低用户认知负担
+YAGNI: 设计中剔除非必要功能，保持精简
+分段验证: 设计分段呈现，逐段确认，及时发现偏差
+灵活回退: 发现问题时可回退重新澄清，不强行推进
+```
+
+---
+
+## 用户选择处理
+
+### 场景: 需求澄清问答
+
+```yaml
+内容要素:
+  - 当前问题（单个）
+  - 选项列表（2-4个，含推荐标注）
+
+选项: 用户选择字母或自由输入
+
+处理规则:
+  有效选择: 记录答案，继续下一个问题或进入方案探索
+  自由输入: 解析用户意图，必要时追问确认
+  "跳过/不确定": 记录为待定，继续流程
+```
+
+### 场景: 方案选择
+
+```yaml
+内容要素:
+  - 方案对比表
+  - 推荐理由
+
+选项: A/B/C 或自定义方案
+
+处理规则:
+  选择方案: 进入设计呈现阶段
+  自定义方案: 根据用户描述调整方案，再次确认
+```
+
+### 场景: 设计段落确认
+
+```yaml
+内容要素:
+  - 当前段落内容
+  - 段落进度（N/M）
+
+选项:
+  确认继续: 进入下一段落
+  需要调整: 用户说明调整需求，修改后重新呈现
+
+处理规则:
+  全部段落确认: 进入方案包生成
+  用户取消: 按 G6 状态重置协议执行
+```

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

@@ -0,0 +1,154 @@
+# ~clean 命令 - 清理遗留方案
+
+本模块定义清理遗留方案包的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~clean
+类型: 场景确认类
+功能: 按照执行流程清理 plan/ 目录中的遗留方案包，列出方案包让用户选择清理范围
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~clean 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. 清理操作需用户确认范围（全部/选择性）
+4. 方案包迁移至 archive/ 而非直接删除
+5. 迁移时标记状态为 skipped
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+> 📌 规则引用: 脚本路径、存在性检查、错误恢复规则见 references/rules/tools.md
+> 📌 规则引用: 目录/文件创建按 G1 "目录/文件自动创建规则" 执行
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 扫描方案包
+
+```yaml
+前置条件: plan/ 目录存在至少一个方案包
+
+脚本调用: list_packages.py
+用途: 获取 plan/ 目录中的方案包列表
+
+无方案包时: 按G3场景内容规则（完成场景）输出提示，流程结束
+
+有方案包时:
+  展示内容: 方案包列表（名称、创建时间、类型）
+  询问选项: 全部清理 / 选择性清理 / 取消
+  按G3场景内容规则（确认场景）输出
+```
+
+### 步骤3: 执行迁移
+
+```yaml
+脚本调用: migrate_package.py <package-name> --status skipped
+参数:
+  package-name: 方案包名称（或使用 --all 迁移全部）
+  --status skipped: 标记为未执行
+
+执行内容: 将选中的方案包迁移至 archive/
+```
+
+**脚本执行报告处理:**
+
+<script_report_handling>
+脚本执行报告处理流程:
+1. 解析脚本输出的 JSON 执行报告
+2. success=true 时继续后续步骤
+3. success=false 时按 tools.md "AI降级接手流程" 执行
+4. 质量检查 completed 步骤后再继续
+</script_report_handling>
+
+```yaml
+解析 migrate_package.py 输出:
+  success=true:
+    - 迁移完成，继续步骤4验收
+
+  success=false:
+    - 执行: 按 references/rules/tools.md "脚本执行报告机制 - AI降级接手流程" 处理
+    - 步骤1: 质量检查 completed 列表中已完成的步骤
+      - 验证方案包存在: 确认源路径
+      - 创建归档目录: 确认 archive/YYYY-MM/ 存在
+      - 更新 tasks.md 状态: 检查 @status 行
+      - 移动方案包: 确认目标路径存在且源已删除
+      - 更新 _index.md: 检查索引记录
+    - 步骤2: 发现问题则修复
+    - 步骤3: 按 pending 列表继续完成（参考 templates.md "AI接手时的文件创建指南"）
+```
+
+### 步骤4: 后续操作
+
+```yaml
+执行规则: 按 G8 命令级验收标准（~clean）执行
+
+验收项:
+  - 目标方案包已迁移 (信息性): 确认方案包已从 plan/ 移至 archive/
+  - 无误删重要文件 (警告性): 确认只迁移了用户选择的方案包
+
+验收方式:
+  - 列出已迁移的方案包清单
+  - 确认 plan/ 目录状态
+
+验收失败处理:
+  警告性失败:
+    - 记录到清理报告
+    - 提示用户检查 archive/ 目录
+
+完成后: 按G3场景内容规则（完成场景）输出清理结果（含验收报告）
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- plan/ 目录不存在 → 按G3场景内容规则（完成场景）输出，提示无需清理
+- 方案包迁移失败 → 报告失败项，继续处理其他方案包
+- archive/ 目录不存在 → 自动创建后继续
+
+---
+
+## 用户选择处理
+
+### 场景: 遗留方案包清理确认
+
+```yaml
+内容要素:
+  - 遗留方案包列表: plan/ 目录下的方案包清单（名称、创建时间、类型）
+  - 方案包摘要: 每个方案包的简要描述
+
+选项:
+  全部清理: 迁移所有遗留方案包至 archive/
+  选择性清理: 列出方案包让用户选择
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 清理后验收完成
+
+```yaml
+内容要素:
+  - 验收状态: 通过/部分通过
+  - 已迁移方案包: 方案包清单（名称、迁移路径）
+  - plan/ 目录状态: 剩余方案包数量（如有）
+  - 问题汇总: 警告信息（如有）
+
+输出格式: 按G3场景内容规则（完成场景）输出
+```

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

@@ -0,0 +1,265 @@
+# ~commit 命令 - Git 提交
+
+本模块定义 Git 提交的执行规则，基于 Conventional Commits 国际规范。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~commit [<message>]
+类型: 场景确认类
+功能: 按照执行流程生成提交信息并执行 Git 提交
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~commit 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. 提交前必须用户确认，不自动执行
+4. 根据远程配置动态显示推送选项
+5. 支持本地提交、推送、创建PR三种模式
+</mode_adaptation>
+
+---
+
+## 执行约束
+
+```yaml
+核心约束:
+  - 本命令只负责提交现有变更，不负责创建变更
+  - 用户描述中的"目标说明"作为提交范围参考，不执行文件操作
+  - 禁止在用户确认前执行任何改变项目文件状态的操作
+```
+
+---
+
+## 执行流程
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 环境检测与变更分析
+
+```yaml
+前置: 步骤1用户确认后执行
+
+环境检测:
+  执行命令:
+    - git rev-parse --git-dir（验证仓库）
+    - git status --porcelain（检测变更）
+    - git remote -v（检测远程配置）
+    - git branch --show-current（获取当前分支）
+
+  异常处理:
+    非 Git 仓库: 按G3场景内容规则（错误场景）输出，建议执行 git init
+    无变更: 按G3场景内容规则（完成场景）输出，提示无需提交
+```
+
+<change_scope>
+变更分析步骤:
+1. 优先使用 git diff origin/{branch}...HEAD 获取与远程的完整差异
+2. 无远程时使用 git diff HEAD 获取本地变更
+3. 新文件(untracked)直接读取文件内容分析
+4. 提取核心改动点，过滤非核心文件
+</change_scope>
+
+```yaml
+变更分析:
+  有远程仓库: git diff origin/{branch}...HEAD（完整变更）
+  仅本地: git diff HEAD（已跟踪文件）
+  新文件: 直接读取文件内容
+  分析目标: 提取核心改动点
+```
+
+<commit_message_generation>
+提交信息生成步骤:
+1. 基于 diff 内容识别变更类型（feat/fix/refactor等）
+2. 过滤非核心文件（README、LICENSE、配置文件等）
+3. 提取实质性变更作为 summary
+4. 描述"改了什么"而非"做了什么动作"
+</commit_message_generation>
+
+```yaml
+提交信息生成:
+  信息来源: 基于 git diff 实际代码变更，非提交动作描述
+  内容过滤: 排除 README*.md、LICENSE*、CHANGELOG*、.gitignore 等
+
+  无参数时:
+    - 分析 diff 识别功能变更/bug修复/重构内容
+    - 根据变更内容确定 type/scope
+    - summary 描述"改了什么"
+    - 示例: "feat(G3): 增加触发源显示规则" 而非 "更新 commit 模块"
+
+  有参数时:
+    - 使用用户提供的 message 作为 summary
+    - 根据语义分析确定 type
+    - 如已包含 emoji/type 前缀，直接使用
+
+输出: 按G3场景内容规则（确认场景）输出，见"用户选择处理 - 提交确认"
+```
+
+### 步骤3: 执行提交与推送
+
+```yaml
+前置: 步骤2用户选择提交方式后执行
+
+执行提交:
+  git add .
+  git commit -m "{提交信息}"
+
+推送处理（用户选择推送时）:
+  推送前检查:
+    git fetch origin
+    git rev-list --count HEAD..origin/{branch}（远程领先数）
+    git rev-list --count origin/{branch}..HEAD（本地领先数）
+
+  自动处理:
+    远程领先: 自动执行 git pull --rebase → 成功则继续推送
+    本地领先: 直接执行 git push origin {branch}
+    分叉状态: 自动执行 git pull --rebase
+    有冲突: 输出冲突信息，提示用户手动处理，流程结束
+
+如用户选择创建PR:
+  推送完成后自动引导创建 PR
+```
+
+### 步骤4: 后续操作
+
+```yaml
+输出内容（按场景）:
+  本地提交: 提交信息摘要 + 提交哈希 + 变更文件数
+  提交并推送: 提交信息摘要 + 已推送到 origin/{branch}
+  提交并创建PR: 提交信息摘要 + PR 创建链接或引导
+
+完成后: 按G3场景内容规则（完成场景）输出
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 非 Git 仓库 → 按G3场景内容规则（错误场景）输出，建议 git init
+- 无变更 → 按G3场景内容规则（完成场景）输出，提示无需提交
+- 远程推送冲突 → 输出冲突信息，提示手动处理
+- 变更类型难以判定 → 默认使用 chore 类型，提示用户确认
+
+---
+
+## 用户选择处理
+
+### 场景: 提交确认
+
+```yaml
+内容要素:
+  - 当前分支和远程仓库状态
+  - 变更摘要（新增/修改/删除文件数）
+  - 关键改动点
+  - 提交信息预览（框线包裹）
+  - 提交方式选项（根据远程配置动态显示）
+
+选项:
+  仅本地提交: 执行 git commit
+  提交并推送: 执行 git commit + git push
+  提交并创建PR: 执行 git commit + git push + 引导创建 PR
+  修改信息: 进入追问流程
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 提交信息修改（追问）
+
+```yaml
+内容要素:
+  - 当前提交信息预览（框线包裹）
+  - 输入方式说明（完整格式/简短描述/确认/取消）
+
+信息满足判定: AI 根据语义判断用户输入是否可作为提交信息
+
+选项:
+  输入满足条件: 更新提交信息，重新展示确认
+  输入"确认": 使用当前信息，重新展示确认
+  输入"取消": 按 G6 状态重置协议执行
+  输入不满足条件: 重新展示追问
+
+循环直到: 用户选择提交方式 或 取消
+```
+
+---
+
+## 附录
+
+### 提交信息格式（Conventional Commits）
+
+#### 基础格式
+
+```
+<emoji> <type>[(scope)]: <summary>
+
+[body]
+
+[footer]
+```
+
+#### 类型映射表
+
+| emoji | type | 说明 |
+|-------|------|------|
+| 🎉 | init | 项目初始化 |
+| ✨ | feat | 新功能 |
+| 🐞 | fix | 错误修复 |
+| 📃 | docs | 文档变更 |
+| 🌈 | style | 代码格式化 |
+| 🦄 | refactor | 代码重构 |
+| 🎈 | perf | 性能优化 |
+| 🧪 | test | 测试相关 |
+| 🔧 | build | 构建系统 |
+| 🐎 | ci | CI 配置 |
+| 🐳 | chore | 辅助工具 |
+| ↩ | revert | 撤销提交 |
+
+#### 格式规则
+
+```yaml
+summary: 动词开头，≤50字符，不加句号
+body: 说明变更动机（可选），每行≤72字符
+footer: 关联 issue 或 BREAKING CHANGE（可选）
+```
+
+### 双语模式
+
+```yaml
+配置: BILINGUAL_COMMIT（见 G1）
+
+BILINGUAL_COMMIT = 0: 仅使用 OUTPUT_LANGUAGE
+BILINGUAL_COMMIT = 1: 本地语言块在上，英文块在下，用 --- 分隔，两块均为完整格式且精确互译
+```
+
+### 特殊场景处理
+
+```yaml
+首次提交:
+  特征: git log 为空
+  处理: type=init，summary 建议"项目初始化"
+
+功能分支:
+  判定: 根据分支命名约定判断（如 feature/*, fix/* 等）
+  处理: 推送后提示创建 PR
+
+破坏性变更:
+  特征: 删除公共 API、修改数据结构等
+  处理: type 后添加 !，footer 添加 BREAKING CHANGE
+
+回滚:
+  触发: 用户说"回滚上次提交"
+  处理: 执行 git revert HEAD，type=revert
+```