@huajiwuyan/hello 3.0.0

package/templates/claude/skills/references/rules/package.md

@@ -0,0 +1,212 @@
+# 方案包生命周期规则
+
+本模块定义方案包的创建、执行、归档等生命周期管理规则。
+
+---
+
+## 规则概述
+
+> 📌 规则引用: 任务状态符号、方案包类型定义见 G7
+
+```yaml
+规则名称: 方案包生命周期规则
+适用范围: 所有涉及方案包操作的命令和阶段
+核心职责:
+  - 定义方案包路径命名规范
+  - 管理方案包创建、执行、归档流程
+  - 处理 Overview 类型方案包特殊逻辑
+  - 执行遗留方案包扫描和清理
+```
+
+---
+
+<package_lifecycle>
+## 核心规则
+
+### 方案包路径
+
+`plan/YYYYMMDDHHMM_{feature}/`
+
+### 生命周期管理
+
+<lifecycle_rules>
+方案包生命周期规则:
+1. 创建阶段: 方案设计完成后创建方案包目录和文件
+2. 执行阶段: 按 tasks.md 逐任务执行，更新任务状态
+3. 归档阶段: 执行完成后迁移至 archive/YYYY-MM/
+4. 同名冲突: 使用版本后缀 _v2, _v3...
+</lifecycle_rules>
+
+```yaml
+创建规则:
+  - 同名冲突时使用版本后缀 _v2, _v3...
+  - 必须包含 proposal.md 和 tasks.md
+
+执行规则:
+  - 按 tasks.md 任务顺序执行
+  - 实时更新任务状态符号
+
+归档规则:
+  - 开发实施完成后强制迁移至 archive/YYYY-MM/
+  - 保持目录名，同名覆盖
+
+验证规则:
+  - 验证脚本: scripts/validate_package.py
+  - 验证项: 必需文件存在性、任务解析、方案类型识别
+  - 任务状态符号: [ ](待执行), [√](已完成), [X](失败), [-](跳过), [?](待确认)
+```
+
+### Overview 类型方案包生命周期
+
+> 📌 规则引用: 创建阶段规则见 G7 "方案包类型判定"
+
+<overview_handling>
+Overview类型处理推理过程:
+1. 检测方案包类型（tasks.md内容分析）
+2. 判断是否为概述文档（无执行任务）
+3. 根据触发来源选择归档方式
+4. 执行归档并更新索引
+</overview_handling>
+
+```yaml
+归档方式:
+  方式1 - 通过 ~exec 命令:
+    - 检测到 overview 类型后询问用户
+    - 用户选择"归档"后直接迁移至 archive/
+    - 迁移时状态标记为 "overview"
+
+  方式2 - 通过 ~clean 命令:
+    - 手动归档遗留方案包
+    - 归档时状态标记为 "overview"
+
+  方式3 - 全授权命令（~auto）:
+    - 静默归档，不执行开发实施步骤
+
+不自动归档:
+  - overview 类型方案包不会在方案设计完成后自动归档
+  - 需要用户通过 ~exec 或 ~clean 手动触发归档
+```
+
+### 已执行方案包迁移（开发实施阶段强制执行）
+
+```yaml
+迁移步骤:
+  1. 更新tasks.md任务状态（使用任务状态符号）
+  2. 非[√]状态任务下方添加备注（格式: `> 备注: {原因}`）
+  3. 迁移至 archive/YYYY-MM/（保持目录名，同名覆盖）
+  4. 更新 archive/_index.md
+```
+
+### 遗留方案包扫描
+
+<scan_rules>
+遗留方案包扫描规则:
+1. 在指定触发时机自动执行扫描
+2. 排除当前正在执行的方案包
+3. 检测到遗留包时提示用户处理
+4. 扫描完成后清除CURRENT_PACKAGE变量
+</scan_rules>
+
+```yaml
+触发时机:
+  - 开发实施完成
+  - 执行命令完成
+  - 全授权命令完成
+  - 方案设计完成
+  - 规划命令完成
+  - 轻量迭代完成
+
+扫描规则:
+  - 扫描: plan/目录下所有方案包
+  - 排除: 本次执行的方案包（CURRENT_PACKAGE）
+  - 清除: CURRENT_PACKAGE变量
+  - 条件: 检测到≥1个遗留方案包时才输出提示
+  - 输出: 按 G3 场景内容规则（确认）输出
+```
+</package_lifecycle>
+
+---
+
+## 异常处理
+
+```yaml
+方案包创建失败:
+  - 检查 plan/ 目录是否存在
+  - 检查命名冲突并使用版本后缀
+  - 仍失败则暂停流程，提示用户处理
+
+迁移失败:
+  - 检查 archive/ 目录是否存在
+  - 检查目标路径权限
+  - 重试一次后仍失败则保留原位置，记录错误
+
+索引更新失败:
+  - archive/_index.md 不存在时自动创建
+  - 写入失败时在完成报告中标注
+```
+
+---
+
+## 规则引用关系
+
+```yaml
+被引用:
+  - G7 方案包类型判定
+  - ~exec 命令（方案包执行和归档）
+  - ~clean 命令（遗留方案包清理）
+  - ~auto 命令（全授权流程）
+  - 开发实施阶段（方案包迁移）
+
+引用:
+  - G7 任务状态符号
+  - G7 方案包类型定义
+  - G7 状态重置协议
+  - G3 场景内容规则
+```
+
+---
+
+## 用户选择处理
+
+> 本章节定义方案包生命周期中需要用户确认的场景，供 G3 输出格式统一提取。
+
+### 场景: Overview类型方案包处理
+
+```yaml
+触发条件: ~exec 命令检测到 overview 类型方案包
+
+内容要素:
+  - 方案包类型: overview（概述文档）
+  - 类型说明: 此方案包为概述文档，无需执行开发任务
+
+选项:
+  归档: 执行方案包迁移至 archive/
+  查看: 显示 proposal.md 内容，再次询问
+  取消: 按 G7 状态重置协议执行
+
+特殊处理:
+  方案设计阶段:
+    - tasks.md 内容标注: "> 无执行任务（概述文档）"
+    - 方案设计完成后不提示"进入开发实施"选项
+    - 下一步选项: 调整 / 完成
+
+  ~auto 命令检测到 overview:
+    - 静默归档，在完成总结中标注"概述文档，已归档"
+
+  归档记录格式:
+    - archive/_index.md 中标注: | {方案包名称} | overview | {日期} | 概述文档 |
+```
+
+### 场景: 遗留方案包扫描
+
+```yaml
+触发条件: 阶段完成时检测到≥1个遗留方案包
+
+内容要素:
+  - 遗留方案包列表: plan/ 目录下的方案包清单（名称、创建时间、类型）
+  - 当前状态: 检测到N个遗留方案包
+
+选项:
+  清理: 执行 ~clean 命令
+  忽略: 继续当前操作
+```

package/templates/claude/skills/references/rules/scaling.md

@@ -0,0 +1,150 @@
+# 大型项目扩展规则
+
+本模块定义大型项目的判定标准和文档分片策略。
+
+---
+
+## 规则概述
+
+```yaml
+规则名称: 大型项目扩展规则
+适用范围: 项目分析阶段
+核心职责:
+  - 判定项目是否达到大型项目规模
+  - 制定文档分片策略
+  - 管理分批处理流程
+  - 优化大型项目读取策略
+```
+
+---
+
+<large_project_rules>
+## 核心规则
+
+### 大型项目规模判定
+
+> 📌 规则引用: 本规则在项目分析阶段执行，不影响复杂度判定。复杂度判定仅基于需求描述推断，不扫描项目目录。
+
+<scale_detection>
+大型项目判定推理过程:
+1. 在项目分析阶段扫描项目结构
+2. 统计源代码文件数量、代码行数、模块数
+3. 判断是否满足大型项目条件
+4. 满足条件时启用文档分片策略
+</scale_detection>
+
+```yaml
+触发时机: 项目分析阶段
+用途: 判断是否需要启用文档分片策略
+
+判定条件（满足任一）:
+  - 源代码文件 > 500
+  - 代码行数 > 50000
+  - 模块数 > 30
+
+判定方式:
+  自动判定: 项目分析阶段扫描项目时自动评估
+  手动验证: project_stats.py [--path <项目路径>]
+
+注意: 此判定与复杂度判定（微调/轻量迭代/标准开发）无关
+```
+
+> 📌 规则引用: 脚本路径规则见 references/rules/tools.md
+
+### 文档分片规则
+
+<sharding_rules>
+文档分片策略:
+1. CHANGELOG: 按年份分片，主文件保留当前年份
+2. modules/: 按类型分类（core/feature/shared）
+3. archive/_index: 按年份分片
+</sharding_rules>
+
+```yaml
+KB_CREATE_MODE 与分片的关系:
+  KB_CREATE_MODE = 0 (OFF):
+    - 跳过分片评估和执行
+    - 原因: 知识库写操作已禁用，分片无意义
+  KB_CREATE_MODE = 1/2/3:
+    - 正常执行分片评估
+    - 满足条件时自动执行分片
+
+CHANGELOG（条目>200时）:
+  - 按年份分片到 CHANGELOG_{YYYY}.md
+  - 主文件保留当前年份 + Unreleased
+  - 分片触发: ~init/~upgrade 或开发实施阶段检测到条件
+
+modules/（模块>30时）:
+  - 按类型分类: core/, feature/, shared/
+  - 每个分类下独立 _index.md
+  - 分片触发: ~init/~upgrade 执行时
+
+archive/_index（归档>200或跨年时）:
+  - 按年份分片: _index-{YYYY}.md
+  - 分片触发: 方案包迁移时自动判定
+```
+
+### 分批处理
+
+<batch_processing>
+分批处理规则:
+1. 检测任务涉及的模块数量
+2. 超过20个模块时启用分批
+3. 优先处理核心模块和高依赖模块
+4. 批次间输出进度报告
+</batch_processing>
+
+```yaml
+触发条件: 任务涉及模块数 > 20
+
+处理方式:
+  - 每批 ≤ 20 个模块
+  - 优先处理核心模块和高依赖模块
+  - 批次间输出进度
+```
+
+### 读取策略
+
+```yaml
+原则:
+  - 先读索引文件快速定位
+  - 按需加载具体文档
+  - 避免一次性读取所有文件
+```
+</large_project_rules>
+
+---
+
+## 异常处理
+
+```yaml
+规模统计失败:
+  - 脚本不可用时使用内置逻辑估算
+  - 无法确定时按非大型项目处理
+  - 输出警告，建议手动确认
+
+分片操作失败:
+  - 保持原文件不变
+  - 输出错误详情
+  - 建议手动执行分片
+
+分批处理中断:
+  - 记录已完成批次
+  - 提供继续选项
+  - 支持从断点恢复
+```
+
+---
+
+## 规则引用关系
+
+```yaml
+被引用:
+  - 项目分析阶段（规模判定）
+  - ~init 命令（知识库初始化分片）
+  - ~upgrade 命令（知识库升级分片）
+
+引用:
+  - references/rules/tools.md（脚本路径规则）
+  - references/services/knowledge.md（CHANGELOG更新规则）
+```

package/templates/claude/skills/references/rules/state.md

@@ -0,0 +1,318 @@
+# 状态管理规则
+
+本模块定义执行单元的状态管理和上下文切换规则。
+
+---
+
+## 规则概述
+
+> 📌 规则引用: 状态变量定义（取值、含义）见 G7 "状态变量定义"，外部工具状态隔离规则见 G6
+
+```yaml
+规则名称: 状态管理规则
+适用范围: 所有命令触发和阶段流转场景
+核心职责:
+  - 定义执行单元类型和上下文边界
+  - 管理命令触发时的状态变量设置
+  - 控制阶段间的状态流转
+```
+
+---
+
+<state_management>
+## 核心规则
+
+### 执行单元类型
+
+<execution_unit_types>
+执行单元分类:
+1. 内部阶段: 完整工作流中的各个执行阶段
+2. 内部命令: 通过~前缀触发的系统命令
+3. 外部工具: 独立运行的第三方工具和服务
+4. 原子操作: 不改变状态的简单交互
+</execution_unit_types>
+
+```yaml
+内部阶段: 需求评估、项目分析、方案设计、开发实施、微调模式、轻量迭代、标准开发
+内部命令: ~auto, ~plan, ~exec, ~init, ~upgrade, ~clean, ~help...
+外部工具: MCP服务器、子代理、插件、第三方Skill等
+原子操作: 对话、咨询问答
+```
+
+### 命令触发状态设置协议
+
+<command_state_protocol>
+命令状态设置推理过程:
+1. 识别用户输入的命令类型
+2. 查找命令对应的状态设置动作
+3. 设置相应的状态变量
+4. 按 G8 加载规则加载对应模块
+5. 执行命令操作
+</command_state_protocol>
+
+用户输入~命令后，通过路由机制执行对应操作：
+
+| 命令 | 状态设置动作 | 命令类型 |
+|------|-------------|----------|
+| ~auto | WORKFLOW_MODE=AUTO_FULL, CURRENT_STAGE=EVALUATE | 需求评估类 |
+| ~plan | WORKFLOW_MODE=AUTO_PLAN, CURRENT_STAGE=EVALUATE | 需求评估类 |
+| ~exec | STAGE_ENTRY_MODE=DIRECT, CURRENT_STAGE=DEVELOP | 目标选择类 |
+| ~init | 无状态变量 | 场景确认类 |
+| ~upgrade | 无状态变量 | 场景确认类 |
+| ~clean | 无状态变量 | 场景确认类 |
+| ~test | 无状态变量 | 场景确认类 |
+| ~commit | 无状态变量 | 场景确认类 |
+| ~review | 无状态变量 | 范围选择类 |
+| ~validate | 无状态变量 | 范围选择类 |
+| ~rollback | 无状态变量 | 目标选择类 |
+| ~help | 无状态变量 | 直接执行类 |
+
+> 📌 规则引用: 命令对应的加载文件见 G8 模块加载表
+
+**执行流程：**
+```
+路由匹配 → 命令确认 → 设置状态变量 → 按 G8 加载规则 → 执行操作
+```
+</state_management>
+
+---
+
+<stage_transition>
+## 阶段流转规则
+
+> 📌 规则引用: 处理路径详情见 G5，本节仅定义状态变量设置
+
+<transition_logic>
+阶段流转推理过程:
+1. 检测当前阶段完成条件是否满足
+2. 确定目标阶段
+3. 设置目标阶段的状态变量
+4. 加载目标阶段对应模块
+5. 开始执行目标阶段
+</transition_logic>
+
+### 需求评估 → 复杂度判定
+
+```yaml
+条件: 评分≥7分 或 用户选择"以现有需求继续"
+动作: 执行复杂度判定，根据结果进入对应模式
+```
+
+### 复杂度判定 → 对应模式
+
+```yaml
+微调模式: CURRENT_STAGE = TWEAK
+轻量迭代: CURRENT_STAGE = ANALYZE → 项目分析 → 方案设计 → 开发实施
+标准开发: CURRENT_STAGE = ANALYZE → 项目分析 → 方案设计 → 开发实施
+```
+
+### 项目分析 → 方案设计
+
+```yaml
+条件: 项目上下文获取完成
+动作: CURRENT_STAGE = DESIGN，读取并执行 references/stages/design.md
+```
+
+### 方案设计 → 开发实施
+
+```yaml
+条件: 方案包创建完成 + 用户确认（或AUTO_FULL自动流转）
+动作: CURRENT_STAGE = DEVELOP，CREATED_PACKAGE = 方案包路径
+```
+
+### 开发实施 → 流程结束
+
+```yaml
+条件: 所有任务执行完成，方案包迁移至archive/
+动作: 按 G7 状态重置协议执行
+```
+
+### 外部工具 → 流程结束/恢复
+
+```yaml
+条件: 工具执行完成
+动作: 清除 ACTIVE_TOOL，按 G6 规则处理恢复
+```
+</stage_transition>
+
+---
+
+<mode_switch>
+## 模式切换协议
+
+> 定义用户在确认阶段选择执行方式时的模式切换规则
+
+### 触发场景
+
+```yaml
+场景: 需求评估阶段的复杂度判定确认
+前提: WORKFLOW_MODE = AUTO_FULL 或 AUTO_PLAN（~auto/~plan命令触发）
+触发: 用户在确认选项中选择"交互执行"
+```
+
+### 切换规则
+
+<mode_switch_protocol>
+模式切换推理过程:
+1. 检测当前 WORKFLOW_MODE 值
+2. 识别用户选择的执行方式
+3. 执行对应的状态变更
+4. 按新模式继续后续流程
+</mode_switch_protocol>
+
+```yaml
+用户选择"确认执行（静默）":
+  动作: 保持当前 WORKFLOW_MODE 不变
+  后续: 按当前模式静默执行
+    - AUTO_FULL: 静默执行直到流程完成
+    - AUTO_PLAN: 静默执行直到方案设计完成
+
+用户选择"交互执行":
+  动作: 设置 WORKFLOW_MODE = INTERACTIVE
+  后续: 切换为交互模式，每阶段输出结果并等待确认
+  注意: 此选项仅在 AUTO_FULL/AUTO_PLAN 模式下可用
+
+用户选择"确认开始"（仅INTERACTIVE模式）:
+  动作: 保持 WORKFLOW_MODE = INTERACTIVE
+  后续: 按交互模式执行，每阶段交互
+```
+
+### 模式切换时机
+
+```yaml
+切换点: 仅在需求评估阶段的复杂度判定确认时
+不可逆性: 一旦切换为INTERACTIVE，当前流程内不会自动切回AUTO模式
+手动切换: 用户可通过取消后重新发起~auto/~plan命令来恢复自动模式
+```
+</mode_switch>
+
+---
+
+<consecutive_commands>
+## 连续命令执行规则
+
+> 定义用户连续执行多个命令时的状态管理边界
+
+### 核心原则
+
+```yaml
+命令隔离原则:
+  - 每个命令是独立的执行单元
+  - 前一个命令完成后，状态重置为初始状态
+  - 新命令从干净状态开始执行
+  - 禁止依赖前一个命令的临时状态
+
+状态保持范围:
+  保持（跨命令）:
+    - 全局配置（OUTPUT_LANGUAGE, KB_CREATE_MODE, BILINGUAL_COMMIT）
+    - 已创建的文件和目录
+    - 已迁移的方案包
+    - 知识库内容
+  重置（每个命令独立）:
+    - WORKFLOW_MODE, CURRENT_STAGE, STAGE_ENTRY_MODE
+    - KB_SKIPPED, CREATED_PACKAGE, CURRENT_PACKAGE
+    - ACTIVE_TOOL, SUSPENDED_STAGE, TOOL_NESTING
+    - SILENCE_BROKEN
+```
+
+### 连续命令场景
+
+<consecutive_scenarios>
+连续命令场景推理:
+1. 识别前一命令是否已完成
+2. 确认状态重置是否已执行
+3. 新命令按独立执行单元处理
+4. 从初始状态开始设置新命令的状态
+</consecutive_scenarios>
+
+```yaml
+场景1 - 命令完成后执行新命令:
+  示例: ~auto 完成 → 用户输入 ~exec
+  状态流程:
+    ~auto 完成 → 状态重置协议执行 → 系统进入 IDLE 状态
+    用户输入 ~exec → 按命令触发协议设置新状态 → 执行 ~exec
+  关键点: ~exec 不继承 ~auto 的任何临时状态
+
+场景2 - 命令取消后执行新命令:
+  示例: ~plan 进行中 → 用户取消 → 用户输入 ~auto
+  状态流程:
+    用户取消 → 状态重置协议执行 → 系统进入 IDLE 状态
+    用户输入 ~auto → 按命令触发协议设置新状态 → 执行 ~auto
+  关键点: 取消和完成对后续命令的影响相同
+
+场景3 - 命令进行中用户输入新命令:
+  示例: ~auto 执行中 → 用户中途输入 ~help
+  处理规则:
+    原子命令（~help等）: 直接响应，不影响当前命令状态
+    流程命令（~auto/~plan/~exec等）: 视为取消当前命令，执行新命令
+  关键点: 流程命令互斥，原子命令可嵌入
+
+场景4 - 自然对话后执行命令:
+  示例: 用户提问 → 得到回答 → 用户输入 ~auto
+  状态流程:
+    对话交互: 系统处于 IDLE 状态，无临时状态变量
+    用户输入 ~auto → 从 IDLE 状态开始，设置命令状态
+  关键点: 对话不产生需要重置的状态
+```
+
+### 命令互斥规则
+
+```yaml
+互斥命令组（同时只能执行一个）:
+  - ~auto
+  - ~plan
+  - ~exec
+  - 自然语言触发的完整工作流
+
+互斥处理:
+  新命令输入时检测:
+    当前有活动流程命令 → 询问用户是否取消当前命令
+    用户确认取消 → 执行状态重置 → 执行新命令
+    用户拒绝取消 → 继续当前命令
+
+非互斥命令（可在流程中执行）:
+  - ~help: 查看帮助，不改变状态
+  - ~validate: 验证操作，只读
+  - 简单对话: 不改变流程状态
+```
+</consecutive_commands>
+
+---
+
+## 异常处理
+
+```yaml
+状态变量设置失败:
+  - 重新读取当前状态
+  - 按命令类型重新设置
+  - 仍失败则输出错误，建议用户重新输入命令
+
+阶段流转中断:
+  - 保持当前阶段状态
+  - 输出中断原因
+  - 提供恢复选项（继续/重试/取消）
+
+外部工具状态隔离失败:
+  - 按 G6 规则尝试恢复
+  - 无法恢复时清除工具状态
+  - 提示用户当前状态
+```
+
+---
+
+## 规则引用关系
+
+```yaml
+被引用:
+  - 所有~命令（状态设置）
+  - 所有阶段模块（阶段流转）
+  - G4 路由架构
+  - references/stages/evaluate.md（模式切换协议）
+
+引用:
+  - G5 执行模式规则（处理路径）
+  - G6 外部工具状态隔离规则
+  - G7 状态变量定义
+  - G7 状态重置协议
+  - G8 模块加载表
+```