@huajiwuyan/hello 3.0.0

package/templates/claude/skills/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: helloagents
+description: "【HelloAGENTS】显式调用入口。使用 /helloagents 或 $helloagents 激活。"
+license: Apache-2.0
+metadata:
+  author: helloagents
+  version: "2.0"
+---
+
+# HelloAGENTS 技能入口
+
+> 本文件在用户显式调用技能时加载（/helloagents 或 $helloagents）。
+> 核心规则在主配置中定义，本文件定义显式调用时的响应规则。
+
+**路径基准:** `SKILL_ROOT: skills/helloagents/` — 本文件及子模块中的相对路径（references/、scripts/、assets/）需添加此前缀。
+
+---
+
+## 显式调用响应规则
+
+当用户通过 `/helloagents` 或 `$helloagents` 显式调用本技能时，输出以下欢迎信息：
+
+```
+💡【HelloAGENTS】- 技能已激活
+
+智能工作流系统，提供结构化任务流程。
+
+### 可用命令
+
+| 命令 | 功能 |
+|------|------|
+| `~auto` | 全授权命令 |
+| `~plan` | 执行到方案设计 |
+| `~exec` | 执行方案包 |
+| `~init` | 初始化知识库 |
+| `~upgrade` | 升级知识库 |
+| `~clean` | 清理遗留方案包 |
+| `~commit` | Git 提交 |
+| `~test` | 运行测试 |
+| `~review` | 代码审查 |
+| `~validate` | 验证知识库 |
+| `~rollback` | 智能回滚 |
+| `~help` | 显示帮助 |
+
+### 使用方式
+
+- 输入 `~命令` 执行特定功能
+- 直接描述需求，系统自动路由到合适的流程
+
+────
+🔄 下一步: 输入命令或描述你的需求
+```
+
+**后续输入处理：** 用户输入后，按照 G4 路由架构处理。
+
+---
+
+## 脚本调用约定
+
+> 脚本调用规范（路径变量、存在性检查、错误恢复）见 references/rules/tools.md
+
+脚本位于 scripts/ 目录，调用时使用 `-X utf8` 确保编码正确：
+
+```yaml
+知识库工具: python -X utf8 "scripts/upgradewiki.py" --scan | --init | --backup | --write <plan.json>
+方案包验证: python -X utf8 "scripts/validate_package.py" [<package-name>]
+方案包创建: python -X utf8 "scripts/create_package.py" "<feature>" [--type <implementation|overview>]
+方案包迁移: python -X utf8 "scripts/migrate_package.py" "<package-name>" [--status <completed|skipped>] [--all]
+方案包列表: python -X utf8 "scripts/list_packages.py" [--format <table|json>]
+项目统计: python -X utf8 "scripts/project_stats.py" [--path <项目路径>]
+```
+
+---
+
+## 模板资源
+
+模板位于 assets/templates/ 目录，结构与知识库一致：
+
+```yaml
+assets/templates/
+  - INDEX.md              # 知识库入口
+  - context.md            # 项目上下文
+  - CHANGELOG.md          # 变更日志
+  - CHANGELOG_{YYYY}.md   # 年度变更日志（大型项目）
+  - modules/_index.md     # 模块索引
+  - modules/module.md     # 模块文档
+  - plan/proposal.md      # 变更提案
+  - plan/tasks.md         # 任务清单
+  - archive/_index.md     # 归档索引
+```

package/templates/claude/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/claude/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/claude/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/claude/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/claude/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/claude/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/claude/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/claude/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/claude/skills/assets/templates/modules/_index.md

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

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

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

package/templates/claude/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/claude/skills/assets/templates/plan/tasks.md

@@ -0,0 +1,49 @@
+# 任务清单: {feature}
+
+目录: `helloagents/plan/{YYYYMMDDHHMM}_{feature}/`
+
+---
+
+## 任务状态符号说明
+
+| 符号 | 状态 | 说明 |
+|------|------|------|
+| `[ ]` | pending | 待执行 |
+| `[√]` | completed | 已完成 |
+| `[X]` | failed | 执行失败 |
+| `[-]` | skipped | 已跳过 |
+| `[?]` | uncertain | 待确认 |
+
+---
+
+## 执行状态
+```yaml
+总任务: X
+已完成: 0
+完成率: 0%
+```
+
+---
+
+## 任务列表
+
+### 1. {阶段/模块名称}
+
+- [ ] 1.1 在 `{文件路径}` 中实现 {具体功能}
+  - 验证: {如何验证}
+
+- [ ] 1.2 在 `{文件路径}` 中实现 {具体功能}
+  - 依赖: 1.1
+
+### 2. {阶段/模块名称}
+
+- [ ] 2.1 {任务描述}
+
+---
+
+## 执行备注
+
+> 执行过程中的重要记录
+
+| 任务 | 状态 | 备注 |
+|------|------|------|