@huajiwuyan/hello 3.0.0

package/templates/codex/skills/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: helloagents
+description: "【HelloAGENTS】显式调用入口。使用 /helloagents 或 $helloagents 激活。"
+license: Apache-2.0
+metadata:
+  author: helloagents
+  version: "2.1"
+---
+
+# HelloAGENTS 技能入口
+
+> 本文件在用户显式调用技能时加载（/helloagents 或 $helloagents）。
+> 核心规则在主配置中定义，本文件定义显式调用时的响应规则。
+
+> 📌 路径基准: SKILL_ROOT、SCRIPT_DIR、TEMPLATE_DIR 由 G7 推断规则确定
+
+---
+
+## 显式调用响应规则
+
+当用户通过 `/helloagents` 或 `$helloagents` 显式调用本技能时，输出以下欢迎信息：
+
+```
+💡【HelloAGENTS】- 技能已激活
+
+智能工作流系统，提供结构化任务流程。
+
+### 可用命令
+
+| 命令 | 功能 |
+|------|------|
+| `~auto` | 全授权命令 |
+| `~plan` | 执行到方案设计 |
+| `~exec` | 执行方案包 |
+| `~init` | 初始化知识库 |
+| `~upgrade` | 升级知识库 |
+| `~clean` | 清理遗留方案包 |
+| `~commit` | Git 提交 |
+| `~test` | 运行测试 |
+| `~review` | 代码审查 |
+| `~validate` | 验证知识库 |
+| `~rollback` | 智能回滚 |
+| `~brain` | 头脑风暴 |
+| `~debug` | 系统化调试 |
+| `~rlm` | RLM 递归语言模型 |
+| `~help` | 显示帮助 |
+
+### 使用方式
+
+- 输入 `~命令` 执行特定功能
+- 直接描述需求，系统自动路由到合适的流程
+
+────
+🔄 下一步: 输入命令或描述你的需求
+```
+
+**后续输入处理：** 用户输入后，按照 G4 路由架构处理。
+
+---
+
+## 脚本调用约定
+
+> 📌 脚本调用规范（路径变量、存在性检查、错误恢复、用法示例）见 references/rules/tools.md
+
+脚本位于 `{SCRIPT_DIR}` 目录，调用时使用 `-X utf8` 确保编码正确。
+
+---
+
+## 模板资源
+
+> 📌 模板文件索引和章节结构见 references/services/templates.md
+
+模板位于 `{TEMPLATE_DIR}` 目录，结构与知识库一致。
+

package/templates/codex/skills/SKILL.toml

@@ -0,0 +1,7 @@
+[interface]
+display_name = "HelloAGENTS"
+short_description = "【HelloAGENTS】显式调用入口。使用 /helloagents 或 $helloagents 激活。"
+icon_small = "./assets/icon-small-400px.svg"
+icon_large = "./assets/icon-large.svg"
+brand_color = "#6366F1"
+default_prompt = ""

package/templates/codex/skills/assets/icon-large.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366F1"/>
+      <stop offset="100%" style="stop-color:#8B5CF6"/>
+    </linearGradient>
+  </defs>
+  <rect width="512" height="512" rx="96" fill="url(#bg)"/>
+  <text x="256" y="340" font-family="Arial, sans-serif" font-size="280" font-weight="bold" fill="white" text-anchor="middle">H</text>
+  <circle cx="400" cy="115" r="48" fill="#22C55E"/>
+  <path d="M375 115 L392 132 L425 99" stroke="white" stroke-width="12" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+</svg>

package/templates/codex/skills/assets/icon-small-400px.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 400">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#6366F1"/>
+      <stop offset="100%" style="stop-color:#8B5CF6"/>
+    </linearGradient>
+  </defs>
+  <rect width="400" height="400" rx="80" fill="url(#bg)"/>
+  <text x="200" y="270" font-family="Arial, sans-serif" font-size="220" font-weight="bold" fill="white" text-anchor="middle">H</text>
+  <circle cx="315" cy="90" r="38" fill="#22C55E"/>
+  <path d="M295 90 L308 103 L335 76" stroke="white" stroke-width="10" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+</svg>

package/templates/codex/skills/assets/templates/CHANGELOG.md

@@ -0,0 +1,24 @@
+# 变更日志
+
+## [Unreleased]
+
+## [X.Y.Z] - YYYY-MM-DD
+
+### 新增
+- **[{模块名}]**: {变更描述}
+  - 方案: [{YYYYMMDDHHMM}_{feature}](archive/{YYYY-MM}/{YYYYMMDDHHMM}_{feature}/)
+  - 决策: {feature}#D001({决策摘要})
+
+### 修复
+- **[{模块名}]**: {修复描述}
+  - 方案: [{YYYYMMDDHHMM}_{fix}](archive/{YYYY-MM}/{YYYYMMDDHHMM}_{fix}/)
+
+### 微调
+- **[{模块名}]**: {微调描述}
+  - 类型: 微调（无方案包）
+  - 文件: {文件路径}:{行号范围}
+
+### 回滚
+- **[{模块名}]**: 回滚至 {版本/提交}
+  - 原因: {回滚原因}
+  - 方案: [{原方案包}](archive/{YYYY-MM}/{原方案包}/)

package/templates/codex/skills/assets/templates/CHANGELOG_{YYYY}.md

@@ -0,0 +1,25 @@
+# 变更日志 - {YYYY}年
+
+> 本文件记录 {YYYY} 年的历史变更
+> 当前年份变更请查看 [CHANGELOG.md](CHANGELOG.md)
+
+## [X.Y.Z] - YYYY-MM-DD
+
+### 新增
+- **[{模块名}]**: {变更描述}
+  - 方案: [{YYYYMMDDHHMM}_{feature}](archive/{YYYY-MM}/{YYYYMMDDHHMM}_{feature}/)
+  - 决策: {feature}#D001({决策摘要})
+
+### 修复
+- **[{模块名}]**: {修复描述}
+  - 方案: [{YYYYMMDDHHMM}_{fix}](archive/{YYYY-MM}/{YYYYMMDDHHMM}_{fix}/)
+
+### 微调
+- **[{模块名}]**: {微调描述}
+  - 类型: 微调（无方案包）
+  - 文件: {文件路径}:{行号范围}
+
+### 回滚
+- **[{模块名}]**: 回滚至 {版本/提交}
+  - 原因: {回滚原因}
+  - 方案: [{原方案包}](archive/{YYYY-MM}/{原方案包}/)

package/templates/codex/skills/assets/templates/INDEX.md

@@ -0,0 +1,36 @@
+# {project_name} 知识库
+
+> 本文件是知识库的入口点
+
+## 快速导航
+
+| 需要了解 | 读取文件 |
+|---------|---------|
+| 项目概况、技术栈、开发约定 | [context.md](context.md) |
+| 模块索引 | [modules/_index.md](modules/_index.md) |
+| 某个模块的职责和接口 | [modules/{模块名}.md](modules/{模块名}.md) |
+| 项目变更历史 | [CHANGELOG.md](CHANGELOG.md) |
+| 历史方案索引 | [archive/_index.md](archive/_index.md) |
+| 当前待执行的方案 | [plan/](plan/) |
+
+## 知识库状态
+
+```yaml
+最后更新: {YYYY-MM-DD HH:MM}
+模块数量: {数量}
+待执行方案: {数量}
+```
+
+## 读取指引
+
+```yaml
+启动任务:
+  1. 读取本文件获取导航
+  2. 读取 context.md 获取项目上下文
+  3. 检查 plan/ 是否有进行中方案包
+
+任务相关:
+  - 涉及特定模块: 读取 modules/{模块名}.md
+  - 需要历史决策: 搜索 CHANGELOG.md → 读取对应 archive/{YYYY-MM}/{方案包}/proposal.md
+  - 继续之前任务: 读取 plan/{方案包}/*
+```

package/templates/codex/skills/assets/templates/archive/_index.md

@@ -0,0 +1,22 @@
+# 方案归档索引
+
+> 通过此文件快速查找历史方案
+> 历史年份: [2024](_index-2024.md) | [2023](_index-2023.md) | ...
+
+## 快速索引（当前年份）
+
+| 时间戳 | 名称 | 类型 | 涉及模块 | 决策 | 结果 |
+|--------|------|------|---------|------|------|
+| {YYYYMMDDHHMM} | {feature} | {类型} | {模块列表} | {feature}#D001,#D002 | ✅完成 |
+
+## 按月归档
+
+### YYYY-MM
+- [YYYYMMDDHHMM_feature](./YYYY-MM/YYYYMMDDHHMM_feature/) - 一句话功能描述
+
+## 结果状态说明
+- ✅ 完成
+- ⚠️ 部分完成
+- ❌ 失败/中止
+- ⏸ 未执行
+- 🔄 已回滚

package/templates/codex/skills/assets/templates/context.md

@@ -0,0 +1,82 @@
+# 项目上下文
+
+## 1. 基本信息
+
+```yaml
+名称: {项目名称}
+描述: {一句话描述}
+类型: {Web应用/CLI工具/库/服务/...}
+状态: {开发中/维护中/稳定}
+```
+
+## 2. 技术上下文
+
+```yaml
+语言: {主要编程语言}
+框架: {使用的框架}
+包管理器: {npm/pip/cargo/...}
+构建工具: {webpack/vite/gradle/...}
+```
+
+### 主要依赖
+| 依赖 | 版本 | 用途 |
+|------|------|------|
+| {依赖名} | {版本} | {用途说明} |
+
+## 3. 项目概述
+
+### 核心功能
+- {功能1}
+- {功能2}
+
+### 项目边界
+```yaml
+范围内:
+  - {做什么}
+范围外:
+  - {不做什么}
+```
+
+## 4. 开发约定
+
+### 代码规范
+```yaml
+命名风格: {驼峰/下划线/...}
+文件命名: {规则}
+目录组织: {规则}
+```
+
+### 错误处理
+```yaml
+错误码格式: {格式说明}
+日志级别: {级别说明}
+```
+
+### 测试要求
+```yaml
+测试框架: {框架名}
+覆盖率要求: {百分比}
+测试文件位置: {路径}
+```
+
+### Git规范
+```yaml
+分支策略: {策略}
+提交格式: {格式}
+```
+
+## 5. 当前约束（源自历史决策）
+
+> 这些是当前生效的技术约束，详细决策过程见对应方案包
+
+| 约束 | 原因 | 决策来源 |
+|------|------|---------|
+| {约束描述} | {简要原因} | [{方案包名}#D{NNN}](archive/{YYYY-MM}/{方案包}/proposal.md#D{NNN}) |
+
+## 6. 已知技术债务（可选）
+
+> 主动识别的需要未来处理的技术问题
+
+| 债务描述 | 优先级 | 来源 | 建议处理时机 |
+|---------|--------|------|-------------|
+| {描述} | P0/P1/P2 | {来源方案包或识别时间} | {建议} |

package/templates/codex/skills/assets/templates/modules/_index.md

@@ -0,0 +1,22 @@
+# 模块索引
+
+> 通过此文件快速定位模块文档
+
+## 模块清单
+
+| 模块 | 职责 | 状态 | 文档 |
+|------|------|------|------|
+| {模块名} | {一句话职责} | ✅/🚧/📝 | [{模块名}.md](./{模块名}.md) |
+
+## 模块依赖关系
+
+```
+{简单的依赖关系图，用文本表示}
+模块A → 模块B → 模块C
+      ↘ 模块D
+```
+
+## 状态说明
+- ✅ 稳定
+- 🚧 开发中
+- 📝 规划中

package/templates/codex/skills/assets/templates/modules/module.md

@@ -0,0 +1,35 @@
+# {模块名}
+
+## 职责
+
+{详细职责描述}
+
+## 接口定义（可选）
+
+> 模块对外暴露的公共API和数据结构
+
+### 公共API
+| 函数/方法 | 参数 | 返回值 | 说明 |
+|----------|------|--------|------|
+| {名称} | {参数列表} | {返回类型} | {功能说明} |
+
+### 数据结构
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| {字段名} | {类型} | {用途说明} |
+
+## 行为规范
+
+> 描述模块的核心行为和业务规则
+
+### {场景名称}
+**条件**: {前置条件}
+**行为**: {预期行为}
+**结果**: {预期结果}
+
+## 依赖关系
+
+```yaml
+依赖: {依赖模块列表}
+被依赖: {被依赖模块列表}
+```

package/templates/codex/skills/assets/templates/plan/proposal.md

@@ -0,0 +1,104 @@
+# 变更提案: {feature}
+
+## 元信息
+```yaml
+类型: 新功能/修复/重构/优化
+方案类型: {pkg_type}
+优先级: P0/P1/P2/P3
+状态: 草稿
+创建: {YYYY-MM-DD}
+```
+
+---
+
+## 1. 需求
+
+### 背景
+{为什么需要这个变更}
+
+### 目标
+{要达成什么目标}
+
+### 约束条件
+```yaml
+时间约束: {如有}
+性能约束: {如有}
+兼容性约束: {如有}
+业务约束: {如有}
+```
+
+### 验收标准
+- [ ] {标准1}
+- [ ] {标准2}
+
+---
+
+## 2. 方案
+
+### 技术方案
+{简要描述实现方式}
+
+### 影响范围
+```yaml
+涉及模块:
+  - {模块1}: {影响说明}
+预计变更文件: {数量}
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| {风险} | 高/中/低 | {措施} |
+
+---
+
+## 3. 技术设计（可选）
+
+> 涉及架构变更、API设计、数据模型变更时填写
+
+### 架构设计
+```mermaid
+flowchart TD
+    A[组件A] --> B[组件B]
+```
+
+### API设计
+#### {METHOD} {路径}
+- **请求**: {结构}
+- **响应**: {结构}
+
+### 数据模型
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| {字段} | {类型} | {说明} |
+
+---
+
+## 4. 核心场景
+
+> 执行完成后同步到对应模块文档
+
+### 场景: {场景名称}
+**模块**: {所属模块}
+**条件**: {前置条件}
+**行为**: {操作描述}
+**结果**: {预期结果}
+
+---
+
+## 5. 技术决策
+
+> 本方案涉及的技术决策，归档后成为决策的唯一完整记录
+
+### {feature}#D001: {决策标题}
+**日期**: {YYYY-MM-DD}
+**状态**: ✅采纳 / ❌废弃 / ⏸搁置
+**背景**: {为什么需要这个决策}
+**选项分析**:
+| 选项 | 优点 | 缺点 |
+|------|------|------|
+| A: {方案A} | {优点} | {缺点} |
+| B: {方案B} | {优点} | {缺点} |
+**决策**: 选择方案{X}
+**理由**: {详细理由}
+**影响**: {对哪些模块有影响}

package/templates/codex/skills/assets/templates/plan/tasks.md

@@ -0,0 +1,29 @@
+# 任务清单: {feature}
+
+<!-- LIVE_STATUS_BEGIN -->
+```
+状态: pending | 进度: 0/X (0%) | 更新: {YYYY-MM-DD HH:MM:SS}
+当前: -
+```
+<!-- LIVE_STATUS_END -->
+
+---
+
+## 任务列表
+
+### 1. {阶段/模块名称}
+
+- [ ] 1.1 在 `{文件路径}` 中实现 {具体功能}
+- [ ] 1.2 在 `{文件路径}` 中实现 {具体功能}
+  - 依赖: 1.1
+
+### 2. {阶段/模块名称}
+
+- [ ] 2.1 {任务描述}
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|

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

@@ -0,0 +1,181 @@
+# ~auto 命令 - 全授权命令
+
+本模块定义全授权命令的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~auto [<需求描述>]
+类型: 完整流程类
+功能: 全授权命令，从需求评估到开发实施，评估需求完整性后进入对应执行模式
+模式: WORKFLOW_MODE = AUTO_FULL
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~auto 模式适配规则:
+1. 本命令固定使用 AUTO_FULL 模式
+2. 评估深度: 完整评估（含评分追问）
+3. 静默模式下自动处理所有决策点
+4. 交互模式下每阶段需用户确认
+5. EHRB 检测始终生效，不受模式影响
+6. 各阶段自动按需调用子代理（按 G9/G10 规则）
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+### 步骤1: 需求评估
+
+```yaml
+设置状态变量:
+  - WORKFLOW_MODE = AUTO_FULL
+  - STAGE_ENTRY_MODE = NATURAL
+
+执行规则: 按 G4 "需求评估规则"执行（完整评估+复杂度判定），按G3场景内容规则（需求评估/复杂度判定场景）输出
+```
+
+### 步骤2: 执行对应模式
+
+```yaml
+根据复杂度判定结果:
+  微调模式: 读取并执行 references/stages/tweak.md
+  轻量迭代/标准开发: 进入步骤3
+```
+
+### 步骤3: 项目分析（仅轻量迭代/标准开发）
+
+```yaml
+执行规则: 读取并执行 references/stages/analyze.md
+
+静默模式: 不输出
+交互模式: 输出阶段完成提示
+```
+
+### 步骤4: 方案设计
+
+```yaml
+执行规则: 读取并执行 references/stages/design.md
+
+复杂任务: 静默模式下自动选择推荐方案
+简单任务: 静默模式下自动确定方案
+overview 类型: 归档至 archive/，跳过开发实施
+
+设置: CREATED_PACKAGE = 本次创建的方案包路径
+```
+
+### 步骤5: 开发实施
+
+```yaml
+执行规则: 读取并执行 references/stages/develop.md
+
+静默模式: 执行所有任务，质量问题在总结中列出
+交互模式: 每个任务完成后提示
+```
+
+### 步骤6: 后续操作
+
+```yaml
+执行规则: 按 G8 "流程级验收规则" 执行（验收内容详见 G8）
+
+遗留方案包扫描:
+  执行规则: 按 G6 "遗留方案包扫描" 执行
+  扫描时机: 流程即将结束时
+  显示条件: 检测到≥1个遗留方案包
+  详细规则: 参考 references/services/package.md "遗留方案包处理"
+
+完成后: 按G3场景内容规则（完成场景）输出全授权命令结果（含验收报告）
+执行: 按 G6 状态重置协议执行
+```
+
+---
+
+## 安全约束
+
+> 📌 规则引用: 按 G2 EHRB 检测规则执行
+
+```yaml
+强制约束:
+  - EHRB 检测始终生效，检测到时必须打破静默
+  - 阻断性测试失败必须中断静默模式
+  - 方案包验收失败（阻断性）必须用户确认
+```
+
+### 打破静默规则
+
+```yaml
+适用时机: 用户选择确认执行后进入静默模式期间
+
+必须打破静默的情况:
+  - 检测到 EHRB（极度高风险行为）
+  - 阻断性测试失败
+  - 方案包验收失败（阻断性）
+  - 无法自动解决的错误
+
+用户响应后:
+  - 有效输入: 恢复静默，继续执行
+  - "取消": 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 需求描述不完整 → 按 G4 需求评估追问循环处理
+- 复杂度难以判定 → 默认使用轻量迭代模式
+- 方案选择冲突 → 静默模式下选择推荐方案
+- 测试失败但非阻断性 → 记录到验收报告，继续执行
+
+---
+
+## 用户选择处理
+
+> 本章节定义 ~auto 命令需要用户确认的场景，供 G3 输出格式统一提取。
+
+### 场景: 执行模式确认（需求评估完成后）
+
+```yaml
+触发条件: WORKFLOW_MODE = AUTO_FULL（~auto命令触发）
+
+内容要素: 按 G4 "复杂度判定确认"场景，额外包含:
+  - 执行方式说明（静默执行 vs 交互执行的区别）
+  - 预计影响范围
+
+选项: 按 G4 "复杂度判定确认"场景（AUTO_FULL/AUTO_PLAN模式）
+
+状态变更: 按 references/rules/state.md "模式切换协议"执行
+```
+
+### 场景: 打破静默确认
+
+```yaml
+内容要素:
+  - 打破静默原因（EHRB/测试失败/方案包验收失败/无法解决的错误）
+  - 问题详情描述
+  - 建议的处理方式
+
+选项:
+  继续执行: 恢复静默，继续执行
+  手动处理: 暂停静默，用户介入处理
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 流程级验收完成
+
+```yaml
+内容要素:
+  - 验收状态: 通过/部分通过/失败
+  - 交付物摘要: 方案包、代码变更、知识库状态
+  - 需求符合性: 已完成项/未完成项
+  - 问题汇总: 警告和信息性记录（如有）
+
+输出格式: 按G3场景内容规则（完成场景）输出
+```