Click Path Audit

作者 affaan-mef648e01899b无许可证275K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库3天前更新

ユーザー向けボタン/タッチポイントを完全な状態変更シーケンスを通して追跡し、機能が個別に機能するが互いにキャンセルされたり、間違った最終状態を生成したり、UIを矛盾した状態にしたままにするバグを見つけます。次の場合に使用します:体系的なデバッグがバグを見つけたが、ユーザーは壊れたボタンを報告する場合、または共有状態ストアに触れる主要なリファクター後。

AI 生成的概览

审计面向用户的点击路径,找出处理函数相互静默抵消的状态交互缺陷。

功能
该技能为交互式 UI 触点提供一套结构化审计流程。它让代理先梳理状态存储及其副作用,再按顺序追踪每个处理函数的调用,查看哪些状态被读取、写入或重置。产出包括存储动作的副作用映射,以及针对每个触点的发现,如被抵消的状态变更、错误的最终状态和竞态条件。
适用场景
适用于系统化调试已发现缺陷但用户仍报告按钮失效的情况,或在触及共享状态存储的大型重构之后使用。它针对静态代码阅读容易遗漏的缺陷,例如副作用、调用顺序冲突以及处理函数之间相互静默撤销。
运行要求
仅包含说明,不附带脚本。需要能够访问应用源代码,包括带交互处理函数的组件以及 Zustand、Redux 或 React context 等共享状态存储。

/click-path-audit — 行動フロー監査

静的コード読み取りが見落とすバグを見つけ:状態相互作用の副作用、順序を付けられた呼び出し間の競合状態、および互いに静かに取り消すハンドラー。

この解決する問題

従来のデバッグチェック:

  • 関数が存在しますか?(不足している配線)
  • クラッシュしますか?(ランタイムエラー)
  • 正しいタイプを返しますか?(データフロー)

しかし、それはチェックしません:

  • 最終UI状態がボタンラベルが約束したものと一致しますか?
  • 関数Bが関数Aが行ったばかりをサイレンス的に取り消しますか?
  • 共有状態(Zustand/Redux/context)に意図した操作をキャンセルする副作用がありますか?

実例:「新しいメール」ボタンがsetComposeMode(true)を呼び出してからselectThread(null)。両方は個別に機能しました。しかし、selectThreadにはcomposeMode: falseをリセットする副作用がありました。ボタンは何もしなかった。54のバグは体系的なデバッグによって見つかりました — これは見落とされました。


動作方法

対象領域のすべてのインタラクティブなタッチポイントについて:

1. ハンドラーを特定(onClick、onSubmit、onChangeなど)2. ハンドラーのすべての関数呼び出しを**順序で**追跡3. 各関数呼び出し**について**:   a. どの状態を読んでいますか?   b. どの状態を書き込んでいますか?   c. 共有状態に副作用がありますか?   d. 副作用として状態をリセット/クリアしますか?4. チェック:後の呼び出しが以前の呼び出しからの状態変更を取り消しますか?5. チェック:最終状態はユーザーがボタンラベルから期待するもの?6. チェック:競合状態がありますか(非同期呼び出しが間違った順序で解決される)?

実行ステップ

ステップ1:マップ状態ストア

任意のタッチポイントを監査する前に、すべての状態ストアアクションの副作用マップを構築:

範囲内の各Zustand ストア / React コンテキストについて:  各アクション/セッター:    - どのフィールドをセットしますか?    - 副作用として他のフィールドをリセットしますか?    - ドキュメント:actionName → {sets: [...], resets: [...]}

これは重要な参照です。「新しいメール」バグはselectThreadがcomposeModeをリセットしていることを知らないと見えなくなりました。

出力形式:

STORE: emailStore  setComposeMode(bool) → sets: {composeMode}  selectThread(thread|null) → sets: {selectedThread, selectedThreadId, messages, drafts, selectedDraft, summary} RESETS: {composeMode: false, composeData: null, redraftOpen: false}  setDraftGenerating(bool) → sets: {draftGenerating}  ...
DANGEROUS RESETS(所有していない状態をクリアするアクション):  selectThread → composeMode をリセット(setComposeModeで所有)  reset → すべてをリセット

ステップ2:各タッチポイントを監査

対象領域の各ボタン/トグル/フォーム送信について:

TOUCHPOINT: [ボタンラベル] in [Component:line]ハンドラー:[関数呼び出しの完全なシーケンス]最終状態:[これが達成されるべきもの]

詳細については、ドキュメントを参照してください。

来源与署名

来源:affaan-m/ecc位于docs/ja-JP/skills/click-path-audit提交ef648e0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架