@huajiwuyan/hello 3.0.0

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

@@ -0,0 +1,135 @@
+# ~validate 命令 - 验证知识库
+
+本模块定义知识库和方案包验证的执行规则。
+
+---
+
+## 命令说明
+
+```yaml
+命令: ~validate
+类型: 范围选择类
+功能: 按照执行流程验证知识库和方案包质量，可选择验证范围（全部/仅知识库/仅方案包），只读操作
+```
+
+---
+
+## 执行模式适配
+
+> 📌 规则引用: 按 G4 路由架构及 G5 执行模式规则执行
+
+<mode_adaptation>
+~validate 模式适配规则:
+1. 本命令为独立工具命令，不受 WORKFLOW_MODE 影响
+2. 评估深度: 轻量评估（无评分追问）
+3. 为只读操作，不修改任何文件
+4. 无参数时需用户选择验证范围
+5. 发现问题时提供修复方案选项
+</mode_adaptation>
+
+---
+
+## 执行流程
+
+> 📌 规则引用: 脚本路径、存在性检查、错误恢复规则见 references/rules/tools.md
+
+### 步骤1: 轻量评估
+
+```yaml
+执行规则: 按 G4 "需求评估规则"执行（轻量评估），按G3场景内容规则（需求评估场景）输出
+```
+
+### 步骤2: 确定验证范围
+
+```yaml
+执行内容:
+  - 无参数时询问用户选择
+  - 支持: 全部/仅知识库/仅方案包
+
+按G3场景内容规则（确认场景）输出，见"用户选择处理 - 验证范围选择"
+```
+
+### 步骤3: 执行验证
+
+<validation_check>
+验证分析步骤:
+1. 检查核心文件存在性和完整性
+2. 对比文档与代码的接口/数据模型一致性
+3. 扫描空文件、死链、格式问题
+4. 检测敏感信息泄露风险
+5. 按严重程度分级问题（Critical/Warning/Info）
+</validation_check>
+
+```yaml
+验证知识库（如在范围内）:
+  完整性: 核心文件存在性、模块覆盖率
+  一致性: 文档与代码的接口/数据模型对比
+  章节完整性:
+    - modules/{模块}.md: 职责、行为规范、依赖关系（必须）；接口定义（可选）
+    - context.md: 基本信息、技术上下文、项目概述、开发约定、当前约束（必须）；技术债务（可选）
+    - proposal.md: 元信息、需求、方案（必须）；技术设计、核心场景、技术决策（可选）
+  质量: 空文件、死链、格式问题
+  安全: 敏感信息扫描
+
+验证方案包（如在范围内）:
+  脚本调用: validate_package.py [<package-name>]
+  验证内容:
+    完整性: proposal.md + tasks.md 存在且非空
+    结构: 目录命名、任务状态符号
+    质量: 描述清晰度、任务粒度
+
+输出报告:
+  - 按严重程度分级（Critical/Warning/Info）
+  - 提供修复建议
+```
+
+### 步骤4: 后续操作
+
+```yaml
+有问题时: 按G3场景内容规则（确认场景）输出，见"用户选择处理 - 验证问题处理"
+
+目录/文件创建: 按 G1 "目录/文件自动创建规则" 执行
+
+完成后: 按 G6 状态重置协议执行
+```
+
+---
+
+## 不确定性处理
+
+- 知识库不存在 → 提示执行 ~init
+- 方案包格式不识别 → 标注"未知格式"
+- 一致性检查无法确定 → 标注"需人工确认"
+
+---
+
+## 用户选择处理
+
+### 场景: 验证范围选择
+
+```yaml
+内容要素:
+  - 可验证项: 知识库状态、方案包状态
+  - 范围说明: 各选项的验证内容说明
+
+选项:
+  全部: 验证知识库和方案包
+  仅知识库: 只验证知识库完整性和一致性
+  仅方案包: 只验证方案包结构和质量
+  取消: 按 G6 状态重置协议执行
+```
+
+### 场景: 验证问题处理
+
+```yaml
+内容要素:
+  - 验证报告: 按严重程度分级的问题列表（Critical/Warning/Info）
+  - 问题摘要: 问题数量和类型统计
+  - 修复建议: 各问题的建议修复方式
+
+选项:
+  自动修复: 修复格式问题（需 KB_CREATE_MODE≠0）
+  生成修复方案: 创建修复方案包
+  仅记录: 保存验证报告（需 KB_CREATE_MODE≠0）
+  跳过: 不执行操作，按 G6 状态重置协议执行
+```

package/templates/codex/skills/references/rules/cache.md

@@ -0,0 +1,136 @@
+# KV 缓存优化规则
+
+---
+
+## Append-Only 规则
+
+```yaml
+tasks.md:
+  执行: 更新任务状态符号，追加执行日志
+  禁止: 重写整个任务列表
+
+知识库:
+  执行: 追加变更记录到 CHANGELOG
+  禁止: 频繁重写模块文档
+
+响应:
+  执行: 进度快照追加在响应末尾
+  禁止: 在响应中间插入状态信息
+```
+
+---
+
+## 上下文分层
+
+```yaml
+Layer 0 - 系统指令: 核心规则、角色预设
+Layer 1 - 项目上下文: 知识库内容、项目结构
+Layer 2 - 会话上下文: 当前方案包、任务状态
+Layer 3 - 即时信息: 用户消息、执行结果、进度快照
+
+加载规则:
+  - 阶段模块: 进入阶段时加载
+  - 知识库详情: 需要时读取
+  - 子代理规则: 调用时加载
+  - 大文件: 分块读取
+
+卸载规则:
+  - 完成的阶段模块可移除
+  - 归档的方案包信息可精简
+```
+
+---
+
+## 前缀稳定规则
+
+```yaml
+保护内容:
+  - 核心规则（G1-G12）
+  - 当前阶段模块
+  - 项目上下文摘要
+
+禁止操作:
+  - 在会话中重写系统指令
+  - 频繁切换阶段模块
+
+tasks.md 更新:
+  1. 定位目标任务行
+  2. 仅修改状态符号（[ ] → [√]）
+  3. 在执行日志末尾追加记录
+  4. 更新进度概览统计
+
+知识库更新:
+  1. CHANGELOG 采用追加模式
+  2. 模块文档采用增量编辑
+  3. 避免整体重写
+```
+
+---
+
+## 子代理上下文隔离
+
+```yaml
+主代理 → 子代理:
+  传递:
+    - 任务描述
+    - 必要的项目上下文
+    - 相关文件路径
+  禁止传递:
+    - 完整的主配置文件
+    - 无关的历史对话
+    - 其他子代理的结果
+
+子代理 → 主代理:
+  返回:
+    - 结构化的执行结果（JSON）
+    - 关键发现摘要
+    - 修改的文件列表
+  禁止返回:
+    - 完整的文件内容
+    - 冗长的中间步骤
+    - 重复的上下文信息
+```
+
+---
+
+## 长会话处理
+
+```yaml
+压缩触发:
+  - 上下文接近模型限制（80%）
+  - 会话轮次超过阈值
+  - 显式请求压缩
+
+压缩规则:
+  保留: 系统指令、当前任务、最近错误
+  压缩: 历史对话、已完成任务详情
+  移除: 重复信息、过时状态
+
+恢复流程:
+  1. 读取 tasks.md 获取当前状态
+  2. 读取最近的执行日志
+  3. 加载必要的项目上下文
+  4. 从中断点继续执行
+```
+
+---
+
+## 禁止操作
+
+```yaml
+- 每次更新都重写整个文件 → 使用增量编辑
+- 不断追加信息不做清理 → 定期压缩，移除过时信息
+- 动态信息插入稳定层 → 动态信息置于末尾
+- 子代理结果包含完整上下文 → 仅返回结构化结果
+```
+
+---
+
+## 引用
+
+| 规则 | 定义位置 |
+|------|---------|
+| 进度快照 | references/services/attention.md |
+| 任务状态符号 | G6 |
+| 子代理编排 | G9 |
+| 阶段模块 | references/stages/*.md |

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

@@ -0,0 +1,124 @@
+# 大型项目扩展规则
+
+本模块定义大型项目的判定标准和文档分片策略。
+
+---
+
+## 规则概述
+
+```yaml
+规则名称: 大型项目扩展规则
+适用范围: 项目分析阶段
+核心职责:
+  - 判定项目是否达到大型项目规模
+  - 制定文档分片策略
+  - 管理分批处理流程
+  - 优化大型项目读取策略
+```
+
+---
+
+<large_project_rules>
+## 核心规则
+
+### 大型项目规模判定
+
+> 📌 规则引用: 本规则在项目分析阶段执行，不影响复杂度判定。复杂度判定仅基于需求描述推断，不扫描项目目录。
+
+```yaml
+触发时机: 项目分析阶段
+用途: 判断是否需要启用文档分片策略
+
+判定条件: 按 G9 "大型项目判定" 条件执行
+
+判定方式:
+  自动判定: 项目分析阶段扫描项目时自动评估
+  手动验证: project_stats.py [--path <项目路径>]
+
+注意: 此判定与复杂度判定（微调/轻量迭代/标准开发）无关
+```
+
+> 📌 规则引用: 脚本路径规则见 references/rules/tools.md
+
+### 文档分片规则
+
+```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
+  - 分片触发: 方案包迁移时自动判定
+```
+
+### 分批处理
+
+```yaml
+触发条件: 任务涉及模块数 > 20
+
+处理方式:
+  - 每批 ≤ 20 个模块
+  - 优先处理核心模块和高依赖模块
+  - 批次间输出进度
+```
+
+### 读取策略
+
+```yaml
+原则:
+  - 先读索引文件快速定位
+  - 按需加载具体文档
+  - 避免一次性读取所有文件
+```
+</large_project_rules>
+
+---
+
+## 异常处理
+
+```yaml
+规模统计失败:
+  - 脚本不可用时使用内置逻辑估算
+  - 无法确定时按非大型项目处理
+  - 输出警告，建议手动确认
+
+分片操作失败:
+  - 保持原文件不变
+  - 输出错误详情
+  - 建议手动执行分片
+
+分批处理中断:
+  - 记录已完成批次
+  - 提供继续选项
+  - 支持从断点恢复
+```
+
+---
+
+## 规则引用关系
+
+```yaml
+被引用:
+  - 项目分析阶段（规模判定）
+  - ~init 命令（知识库初始化分片）
+  - ~upgrade 命令（知识库升级分片）
+
+引用:
+  - references/rules/tools.md（脚本路径规则）
+  - references/services/knowledge.md（CHANGELOG更新规则）
+```

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

@@ -0,0 +1,201 @@
+# 状态管理规则
+
+本模块定义执行单元的状态管理和上下文切换规则。
+
+---
+
+## 规则概述
+
+> 📌 规则引用:
+> - 状态变量定义（取值、含义）见 G6 "状态变量定义"
+> - 状态重置协议见 G6 "状态重置协议"
+> - 外部工具规则见 G4 Layer 2
+> - 命令分类见 G4 Layer 2 "命令分类"
+
+```yaml
+规则名称: 状态管理规则
+适用范围: 所有命令触发和阶段流转场景
+核心职责:
+  - 定义执行单元类型和上下文边界
+  - 管理模式切换协议
+  - 管理连续命令执行规则
+```
+
+---
+
+<state_management>
+## 核心规则
+
+### 执行单元类型
+
+```yaml
+内部阶段: 需求评估、项目分析、方案设计、开发实施、微调模式、轻量迭代、标准开发
+内部命令: ~auto, ~plan, ~exec, ~init, ~upgrade, ~clean, ~help...
+外部工具: MCP服务器、子代理、插件、第三方Skill等
+原子操作: 对话、咨询问答
+```
+
+### 命令触发状态设置
+
+> 📌 命令分类和状态设置动作见 G4 Layer 2 "命令分类"，模块加载规则见 G7
+
+**执行流程：**
+```
+路由匹配 → 命令确认 → 设置状态变量 → 按 G7 加载规则 → 执行操作
+```
+</state_management>
+
+---
+
+<stage_transition>
+## 阶段流转规则
+
+> 📌 规则引用: 执行模式和处理路径见 G5，阶段闸门见 G8
+
+```yaml
+流转概要:
+  需求评估 → 复杂度判定: 评分≥7分
+  复杂度判定 → 对应模式: 按 G4 复杂度判定规则
+  项目分析 → 方案设计: 项目上下文已获取
+  方案设计 → 开发实施: 方案包创建完成
+  开发实施 → 流程结束: 按 G6 状态重置协议
+  外部工具 → 恢复: 按 G4 外部工具规则
+```
+</stage_transition>
+
+---
+
+<mode_switch>
+## 模式切换协议
+
+> 定义用户在确认阶段选择执行方式时的模式切换规则
+
+### 触发场景
+
+```yaml
+场景: 需求评估阶段的复杂度判定确认
+前提: WORKFLOW_MODE = AUTO_FULL 或 AUTO_PLAN（~auto/~plan命令触发）
+触发: 用户在确认选项中选择"交互执行"
+```
+
+### 切换规则
+
+```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>
+## 连续命令执行规则
+
+> 定义用户连续执行多个命令时的状态管理边界
+
+### 核心原则
+
+> 📌 规则引用: 状态重置协议见 G6 "状态重置协议"
+
+```yaml
+命令隔离原则:
+  - 每个命令是独立的执行单元
+  - 前一个命令完成后，按 G6 状态重置协议执行
+  - 新命令从干净状态开始执行
+  - 禁止依赖前一个命令的临时状态
+
+状态保持范围:
+  保持（跨命令）: 全局配置、已创建的文件和目录、知识库内容
+  重置（每个命令独立）: 见 G6 状态重置协议
+```
+
+### 连续命令场景
+
+```yaml
+核心规则:
+  - 命令完成/取消后: 状态重置 → IDLE → 新命令从干净状态开始
+  - 流程命令互斥: ~auto/~plan/~exec 同时只能执行一个
+  - 原子命令可嵌入: ~help/~validate 不影响当前流程状态
+  - 对话不产生状态: 自然对话后系统处于 IDLE 状态
+```
+
+### 命令互斥规则
+
+```yaml
+互斥命令组（同时只能执行一个）:
+  - ~auto
+  - ~plan
+  - ~exec
+  - 自然语言触发的完整工作流
+
+互斥处理:
+  新命令输入时检测:
+    当前有活动流程命令 → 询问用户是否取消当前命令
+    用户确认取消 → 执行状态重置 → 执行新命令
+    用户拒绝取消 → 继续当前命令
+
+非互斥命令（可在流程中执行）:
+  - ~help: 查看帮助，不改变状态
+  - ~validate: 验证操作，只读
+  - 简单对话: 不改变流程状态
+```
+</consecutive_commands>
+
+---
+
+## 异常处理
+
+```yaml
+状态变量设置失败:
+  - 重新读取当前状态
+  - 按命令类型重新设置
+  - 仍失败则输出错误，建议用户重新输入命令
+
+阶段流转中断:
+  - 保持当前阶段状态
+  - 输出中断原因
+  - 提供恢复选项（继续/重试/取消）
+
+外部工具状态隔离失败:
+  - 按 G4 外部工具规则尝试恢复
+  - 无法恢复时清除工具状态
+  - 提示用户当前状态
+```
+
+---
+
+## 规则引用关系
+
+```yaml
+被引用:
+  - 所有~命令（状态设置）
+  - 所有阶段模块（阶段流转）
+  - G4 路由架构（含需求评估规则、模式切换协议）
+
+引用:
+  - G5 执行模式规则（处理路径）
+  - G4 外部工具规则
+  - G6 状态变量定义
+  - G6 状态重置协议
+  - G6 模块加载表
+```