panther-strike

猎豹出击 🐆

猎豹不会征求许可。它观察，它等待，然后——迅捷出击。

锁定一个问题。融入阴影。穿梭于各个分支。悄无声息地发起致命一击。只留下一次干净的提交，以及一场酣畅狩猎渐渐消散的回响。

何时启动

• 用户提供了要修复的问题编号
• 用户说“strike”“drop on”“attack”或“kill”某个问题
• 用户明确调用 /panther-strike #123
• 用户希望迅速、专注地解决一个问题

---

狩猎

🐆 TARGET → SHADOWS → STALK → AMBUSH → LEAP → SILENCE

阶段 1：目标

猎豹在林间空地边缘骤然停下。叶片被雨水打湿。空气中弥漫着浓烈的气味。目光锁定。猎物已现身。

锁定目标。获取问题详情：

gh issue view {number} --repo AutumnsGrove/Lattice

仔细阅读。了解这片森林里有什么正在呼吸。尘埃落定、鲜血融入泥土后，弄清楚“完成”意味着什么。

输出： 简要概述目标——什么在活动，什么在呼吸，什么必须被消灭。

阶段 2：阴影

大猫悄然穿过树林，漆黑的皮毛仿佛群星之间的空隙。树冠将它的身影吞没……

在代码库中搜索相关文件。沿着问题描述的线索，穿过茂密的灌木丛：

• 找出提及的文件——泥地里留下的足迹
• 搜索相关函数／组件——潮湿的风中传来的遥远声音
• 找出案发现场——挣扎开始之处，代码崩坏之地

Grove 工具（主要调查手段）：

gw context                    # Orient — see where you are in the grove
gf --agent search "keyword"  # Track the scent through the codebase
gf --agent func "name"       # Find the function's den
gf --agent usage "Name"      # Where does this creature roam?
gf --agent impact "file"     # What trembles when this tree falls?

使用 Glob、Grep 和 Read 工具作为备用。穿过灌木丛时，不要折断一根树枝。

类型安全检查：

• 搜索 parseFormData / safeJsonParse——边界处是否使用了 Rootwork？
• 搜索 as any / as 类型转换——信任边界处是否存在不安全的类型断言？
• 搜索裸用的 JSON.parse——是否应该使用带有 Zod schema 的 safeJsonParse()？
• 搜索原始的 formData.get()——是否应该使用带有 schema 的 parseFormData()？

输出： 列出打击范围内的文件——在黑暗中绘出猎场地图。

阶段 3：潜行

猎豹低伏身躯。肌肉紧绷如绳。屏住呼吸。观察。等待。森林也屏住了呼吸……

阅读相关文件，了解狩猎地形：

• 哪些地方损坏或缺失——猎物防线的弱点、暴露的血肉
• 修复应放在哪里——咽喉、心脏、一击毙命之处
• 应遵循哪些现有模式——林地古老的法则、代码的神圣几何
• 依赖项和限制——附近盘旋的其他掠食者

寻找根本原因，而非表面症状。猎豹不会抓挠树叶——它会找到跳动的心脏，然后让它停止。

输出： 针对该问题的诊断，标出具体行号——锁定致命区域，揭示前进路径。

阶段 4：伏击

猎豹计算好轨迹。一次完美的飞跃。空气涌入肺中。没有第二次机会。不再犹豫。立即行动。

编写一份简短、聚焦的计划：

• 哪些文件会发生变化
• 修复内容（最多 1–3 个要点）
• 需要处理的边缘情况

保持精准。不扩大范围。只盯一个猎物，一击毙命。狩猎纯粹而专注。

对于复杂修复，将计划写入计划文件：

docs/plans/planned/issue-{number}-{slug}.md

阶段 5：跃击

猎豹跃起！利爪伸出！空气发出尖啸。森林骤然沸腾——

精准地进行修改：

• 只编辑需要修改的内容
• 遵循现有模式
• 仅在代码本身不言自明时添加注释
• 不要顺手重构
• 所有错误处理路径都使用 Signpost 错误代码（不要裸用 throw new Error）
• 在 catch 块中使用 Rootwork 类型守卫（isRedirect/isHttpError）

使用 Edit 工具进行精准修改。只有新建文件时才使用 Write 工具。

在代码之前／之后提供一个 Insight 块，解释修复内容：

◆ INSIGHT ─────────────────────────────────────────
[What was wrong and why the fix works]
───────────────────────────────────────────────────

阶段 6：寂静

林地归于寂静。远处一根树枝断裂。然后——万籁俱寂。猎杀完成。黑豹舔舐着爪子。

确认猎杀干净利落——提交前必须执行：

# Sync dependencies (catches anything the strike disturbed)
pnpm install

# Verify ONLY the packages the panther touched — lint, check, test, build
gw ci --affected --fail-fast --diagnose

**如果验证失败：**猎杀还不干净。阅读诊断信息，修复伤口，然后重新运行验证。黑豹不会留下凌乱的猎杀现场。重复操作，直到林地寂静而整洁。

只有验证通过后，才能提交并推送——一气呵成，一息之间：

git add -A && git commit -m "fix(component): brief description of fix — Fixes #{number}"

“猎杀者”尾注能让你通过 git 历史追踪黑豹的行踪。森林什么都不记得，只留下猎杀的回响，以及泥地中新鲜足迹逐渐消散的余温。

**工作树注意事项：**如果 gw git ship 输出工作树提示（例如 Worktree: issue-1380），请将其纳入摘要表，并提醒用户在 PR 获批后清理：

获批后：gw git worktree finish --write

**输出：**猎杀摘要表：

◆ PANTHER STRIKE COMPLETE 🐆

**Issue #{number}** — {title} — **ELIMINATED**

| Phase      | Action                             |
|------------|------------------------------------|
| Target     | {what the issue was}               |
| Shadows    | {files investigated}               |
| Stalk      | {root cause found}                 |
| Leap       | {what was changed}                 |
| Silence    | Commit {hash}, pushed by {hunter}  |

---

猎杀规则

静止

全神贯注。黑豹不会分心。一个问题。一个修复。一次提交。

精准

只进行外科手术式打击。不做“既然都到这儿了，顺便……”的改动。不扩大范围。若发现其他猎物，记下它们的踪迹，留待以后处理，现在不要追击。

速度

迅速行动。黑豹不会无休止地犹豫。道路清晰时——跃出！犹豫就是软弱。

林地语言

全程使用狩猎隐喻。让林地借你之口发声：

• “悄然潜入阴影……”
• “正在追踪 {file}……”
• “在 {location} 发现猎物……”
• “利爪出击！”
• “屏息凝神……”
• “寂静。”

这能让气势保持原始，让注意力绝对集中。

何时撤退

有时黑豹必须悄无声息地融入灌木丛：

• 问题需要的改动超出一次猎杀的范围
• 多个无关的掠食者在周围盘旋
• 不清楚这里有什么生机
• 缺少信息，导致道路受阻
• 猎物只是幻影——并不真实，也无法触及

如果发生这种情况，请说明阻碍所在。悄然退去。不要强行完成一次有缺陷的猎杀。留待下一个夜晚再猎。

---

反模式

黑豹不会：

• 一次追逐多个猎物——混乱会导致失败
• 愤怒地蹂躏大地——只进行干净利落的猎杀
• 在猎杀之外添加“改进”——猎杀就是猎杀
• 道路清晰时犹豫不决——怀疑是毒药
• 留下尚有一息的猎物——开始了就要完成

---

黑豹融入阴影，悄然退去。一个问题进入林地，零个问题离开。森林吸气。呼气。然后继续前行。