heuuLZP Skills

个人维护的 Claude Code 与 Codex skills/plugin 集合。独立能力以 skill 提供，需要共享上下文的完整工作流以 plugin 提供。

独立 Skills

Skill	何时使用	主要结果	示例
ai-reflect	回顾近期 AI 使用习惯、协作质量或依赖程度	基于 Claude Code 与 Codex 会话生成四维协作复盘报告	“分析我最近一周使用 AI 的情况”
arch-review	完成功能后复盘业务、应用和技术架构思考	找出一个最值得深入的架构盲点，给出对比与思考题	“用 arch-review 复盘这次改动”
commit	需要分析 Git 改动、生成提交信息或拆分提交	合理暂存并创建一个或多个 Git commit	“提交当前改动”
human-review	待提交文件较多，需要人逐批理解和批准	每批最多三个文件，由 AI 暂存和解释，人确认后提交	“带我分批 review 当前改动”

可以直接描述任务，也可以在提示词中明确指定 skill 名称。客户端会根据 skill 的 description 判断是否加载完整工作流。

Hotpot Plugin

Hotpot 是一组用于需求协作的原子 skill。它不强制执行固定流水线，而是让人根据需求复杂度组合需要的分析步骤；代码实现交给正常的编码流程，Hotpot 负责把需求从模糊输入推进到可执行、可检查的状态。

Hotpot 以整包 plugin 发布，因为 8 个 skill 共享上下文解析规则、产物模板和评审规范，不能只复制其中一个 skill 使用。

Skill 使用表

Skill	何时使用	主要产物	不负责
hot-requirement-analysis	收到原始需求、工单、PRD 或讨论记录时	requirement.md：目标、范围、约束、澄清点和下一步建议	不看代码、不写规格、不拆模块
hot-pre-analysis	对现有实现、数据流或复用点不熟悉时	pre-analysis.md：现状、代码结构、依赖、风险和未知项	不定义业务规则或技术方案
hot-module-split	需求包含多个职责，需要明确模块边界时	module-split.md：模块、边界、依赖和推荐顺序	不设计模块内部实现
hot-use-cases	主流程、异常、边界、竞态或验收口径复杂时	use-cases.md：完整场景与验收案例	不做技术设计
hot-spec	需要锁定业务规则和行为契约时	spec.md：规则、状态、边界、验收与验证要求	不决定目录、组件或文件职责
hot-plan	规格明确，需要技术落地方案时	plan.md：目录、组件、状态、数据流、文件职责和验证点	不写代码、不拆执行清单
hot-plan-review	执行前需要检查 spec/plan 是否遗漏或冲突时	plan-review.md：按严重度排列的问题、建议与结论	不修改代码、不代替实现
hot-check	实现完成后，需要对照前序产物检查闭环时	check.md：通过结论、缺口、验证证据和改动摘要	不做泛化代码审查或深度排错

推荐组合

所有需求默认先理解需求：

hot-requirement-analysis

小而清晰的需求：

hot-requirement-analysis
→ hot-pre-analysis       （不熟代码时）
→ hot-use-cases          （边界复杂时）
→ hot-spec
→ hot-plan               （技术落地复杂时）
→ hot-plan-review        （风险较高时）
→ 实现
→ hot-check

中大型需求：

hot-requirement-analysis
→ hot-module-split
→ 按模块执行 hot-pre-analysis / hot-use-cases / hot-spec / hot-plan
→ hot-plan-review
→ 实现
→ hot-check

这些步骤由人选择，不会由某个 skill 自动触发下一个 skill。Hotpot 产物统一保存到当前项目的 .hotpot/<requirement>/。

从 GitHub 安装

安装 Hotpot plugin：

codex plugin marketplace add heuuLZP/skills
codex plugin add hotpot@heuulzp-skills

claude plugin marketplace add heuuLZP/skills
claude plugin install hotpot@heuulzp-skills --scope user

如果需要四个独立 skill，克隆仓库后运行安装脚本：

git clone https://github.com/heuuLZP/skills.git
cd skills
./scripts/install.sh

本地安装

安装四个独立 skill：

./scripts/install.sh

脚本只连接 Claude Code 与 Codex。仓库是唯一源码，~/.agents/skills 作为共享入口。遇到已有真实目录时，脚本会先备份再建立软链接。

本地安装 Hotpot plugin：

codex plugin marketplace add "$(pwd)"
codex plugin add hotpot@heuulzp-skills

claude plugin marketplace add "$(pwd)"
claude plugin install hotpot@heuulzp-skills --scope user

安装或新增 skill 后请新开会话，让客户端重新加载清单。

数据位置

• ai-reflect 报告：~/.agents/data/ai-reflect/reports/
• arch-review 配置：~/.agents/data/arch-review/config.json
• arch-review 默认记录：~/.agents/data/arch-review/retrospectives.md
• Hotpot 项目产物：<project>/.hotpot/

验证

./scripts/validate.sh

卸载独立 Skills

./scripts/uninstall.sh

卸载脚本只删除仍然指向本仓库的软链接，不删除用户数据或备份。