القائمة
Hit 项目实测流程专用 skill。按 TEST_FLOW.md 执行完整命令测试，生成 REPORT.md 测试报告，并更新 BUGS.md 记录新发现的问题。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | test-flow |
| description | Hit 项目实测流程专用 skill。按 TEST_FLOW.md 执行完整命令测试，生成 REPORT.md 测试报告，并更新 BUGS.md 记录新发现的问题。 |
| license | MIT |
| compatibility | Hit 项目 |
| metadata | {"version":"1.0.0"} |
| allowed-tools | Shell Read Write Edit Glob Grep |
| user_invocable | true |
| disable_model_invocation | false |
按 docs/bugs/TEST_FLOW.md 定义的完整流程执行命令测试，生成测试报告并更新 bug 记录。
严格遵守：只测试，不修改代码。
docs/bugs/BUGS.mddocs/bugs/REPORT.md| 文档 | 路径 | 用途 |
|---|---|---|
| TEST_FLOW.md | docs/bugs/TEST_FLOW.md | 测试用例清单和预期结果 |
| REPORT.md | docs/bugs/REPORT.md | 测试报告输出文件 |
| BUGS.md | docs/bugs/BUGS.md | Bug 记录（新增问题写入） |
| SOLVED_BUGS.md | docs/bugs/SOLVED_BUGS.md | 已解决的 Bug |
检查 hit 是否已安装且可用：
hit --version # 应输出版本号
hit prefix # 应输出安装根目录
如果未安装，按 TEST_FLOW.md §0.1-§0.2 进行构建和安装。
读取 docs/bugs/TEST_FLOW.md，确认：
按 TEST_FLOW.md 的顺序逐一执行测试命令。注意：
执行命令的通用格式：
# 正常命令
hit <command>
# 预期失败的命令（记录错误）
hit <command> 2>&1
将所有测试结果写入 docs/bugs/REPORT.md，格式如下：
# Hit 实测报告（自动批量执行）
> 生成时间: <日期>
> 按 TEST_FLOW.md 顺序，stdout 入本文件，stderr(WARN) 入 REPORT_warn.log。
> 跳过: §1/§15/§12.3.1/§20/§14.2/§14.4/§19.4
────────────────────────────────────────────────
## §<章节号>
────────────────────────────────────────────────
命令: hit <command>
输出（原样）:
<命令输出内容>
对比测试结果与预期结果，将新发现的 bug 追加到 docs/bugs/BUGS.md。注意：
新 bug 插入位置：在"已修复"部分之前。
输出测试总结，包括：
| 章节 | 原因 |
|---|---|
| §1 | 首次启动引导（交互式菜单） |
| §15 | 交互式搜索安装（TUI 需要真实终端） |
| §12.3.1 | 打开浏览器访问主页 |
| §14.2 | 需要手动删除 junction（破坏性） |
| §14.4 | 需要手动创建损坏的 shim 文件（破坏性） |
| §19.4 | 需要无网络环境 |
| §20 | 完全卸载验证（破坏性，会清除测试环境） |
| 模块 | 测试项数 | 对应章节 |
|---|---|---|
| 首次引导 | 4 | §1 |
| Bucket 管理 | 11 | §2 |
| 搜索 | 5 | §3 |
| 详情 | 4 | §4 |
| 安装 | 7 | §5 |
| 列表 | 4 | §6 |
| 版本管理 | 10 | §7 |
| 更新 | 5 | §8 |
| 卸载 | 5 | §9 |
| 缓存 | 5 | §10 |
| 清理 | 4 | §11 |
| 路径查询 | 5 | §12 |
| 配置 | 10 | §13 |
| 健康检查 | 4 | §14 |
| 交互搜索 | 6 | §15 |
| 系统状态 | 2 | §16 |
| 命令简写 | 9 | §17 |
| 日志级别 | 3 | §18 |
| 错误处理 | 5 | §19 |
| 完全卸载 | 5 | §20 |
| 合计 | 108 |
新增 bug 时按以下格式插入：
## <Bug 标题> ⭐⭐⭐⭐⭐
### 现象
<详细描述问题现象，包含命令和错误输出>
### 证据
<测试轮次>实测 §<章节号>
pwsh），不要用 powershell（5 版本）。TEST_FLOW.md 标注 PS5+ 兼容，但按项目约定统一使用 pwshhit 命令在 PATH 中，可用 hit --version 验证Hit 项目发布 skill。构建 release 资产， 根据用户提示生成草稿内容，等待用户审核后执行发布命令 （git tag / push / gh release create / git cnb release create）。
Hit 项目代码审查专用 skill。按 TODO.md 阶段对完成代码做结构化审查， 覆盖 Rust 代码质量、安全审计，按标准报告格式输出审查报告。
阅读代码审查报告，逐项核实问题，决定是否需要修改， 并在报告末尾追加「报告回执」章节。 当用户说"写回执"、"回复审查"、"处理 review"时触发。
Review Hit 项目 docs/ 下全部文档的跨文档一致性——检查文件存在性、交叉引用、表格格式、编号连贯性、内容冲突
创建 Hit 项目的新 workspace crate 子模块。用于用户需要添加新 crate 时自动搭建 Cargo.toml 和 src/lib.rs 骨架并注册到 workspace。
验证 Hit 项目代码完整性——运行编译检查、静态分析和全部测试。在用户要求"验证改动"、"跑一遍检查"、或完成任务准备收尾时使用。