Skip to content

hopkinson/spotter / skills/spot-trace

spot-trace

Verified

只读整理指定功能的全景路线:生成界面草图、交互状态流转、调用与数据链路、涉及代码清单(精确到文件与符号)和实施落地路线。用于整理或走查功能全景。

功能全景梳理

spot-trace <功能名或模块> 只读拆解功能的全景走查路线(用户提问「整理 xxx 功能」、「梳理 xxx 链路」时触发)。不修改业务代码。

读取 ../../bundled-skills/spot-before-after-sketch/SKILL.md(未找到时退回本机同名版本),用其草图规范展示界面与交互。

按以下 5 部分按序输出,保持信息紧凑,直入主题:

1. 界面/场景草图

  • 使用纯文本 ASCII 框图画出该功能涉及的核心页面、区域布局或弹窗线框。
  • 标出核心操作元素(按键、输入框、展示字段、状态指示)。如果是无界面功能(纯后台 API/批处理),画出数据输入输出场景卡片。

2. 交互状态流转

  • 提炼用户操作或系统触发的主干路径:触发动作 → 状态迁移 → 结果反馈。
  • 覆盖关键边界分支(Loading、空数据、校验失败、权限拦截、网络异常)。

3. 调用与数据链路

  • 沿端到端执行流追踪拓扑: 触发入口 (UI/API) → 路由/中间件 → 控制器/服务层 (Service/Logic) → 数据模型/缓存/存储 (DB/Storage) → 外部服务/事件派发
  • 标出关键入参和返回数据结构的核心字段。

4. 涉及代码清单

  • 查找当前工作区手写源码,列出真实存在的文件路径、关键符号(组件/类/函数/Hook)及大致行号:
    • 前端/交互层:path/to/file.tsx:line(负责渲染与用户事件)
    • 业务/控制器层:path/to/service.ts:line(负责业务规则与流转)
    • 数据/配置层:path/to/model.ts:line(负责存储与契约)
  • 严禁脑补不存在的文件或符号,必须基于代码搜索或图谱核实。

5. 实施/排查路线(带风险标注)

  • 给出按依赖顺序排好的落地路线图,在每一步前置标注风险等级:
    • [轻量/直改]:局部文案、简单样式、可逆且无副作用的细微调整。
    • [中风险/一次确认]:独立组件交互、服务内部逻辑调整,直接给拟议 diff 确认。
    • [完整路径/两次确认]:涉及权限、金额、数据持久化、Schema 迁移或跨模块写入。
  • 附带 1~2 条最容易踩坑的边界注意事项。

梳理收尾流转(自适应接力)

  • 按公共规则「统一收尾」选择一个首选操作;仅了解链路、没有实施目标时自然结束,不强行引导改代码。
  • 有明确实施目标时,推荐依赖已满足的一步,写出具体编号与名称,例如 回复「开始实施第 2 步:增加空态提示」。会话根据该步骤的风险标签自适应接力:
    • [轻量]:直接就地修改并跑验证;
    • [中风险]:就地给出该步拟议 diff 与测试,一次确认后开工;
    • [完整路径]:自动转入 spot-plan 开启需求草图与 diff 两次确认。
  • 目标是全局新功能且尚未明确需求时,首选 调用 spot-plan <具体需求>;发现需要诊断的特定链路缺陷时,首选 调用 spot-bug <具体现象>。按实际目标选择,不把三个入口同时列为下一步。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall