
先问清,再动手,改完有证据 | Clarify first. Prove after. Remember everything. Risk-aware workflows for Codex
先问清,再动手,改完有证据 | Clarify first. Prove after. Remember everything. Risk-aware workflows for Codex / Claude Code / Antigravity
·
AI 编程最大的痛点不是写不出代码,而是「代码黑盒与失控」:传统 AI 回复冗长啰嗦、废话多,且未经确认就乱改代码,导致项目如同黑盒,久而久之无人敢动。
Spotter 为 AI 助手注入了三大核心防线,拒绝客套与黑盒:
/spot-plan)你发令:
/spot-plan 把订单列表的「新建」按钮改为「新建订单」AI 只读核查,一屏直出改前改后草图与拟议 diff(绝不擅改业务代码):
[改前] [ 搜索框 ] [ 状态筛选 ▼ ] [ + 新建 ]
[改后] [ 搜索框 ] [ 状态筛选 ▼ ] [ + 新建订单 ]
-------------------------------------------------------------
拟议修改:
- 前端:app/pages/orders.vue(假设项目使用此路径)
- 核心 diff:- 新建 / + 新建订单(仅改按钮文案)
【下一步操作】回复「开工」你回复「开工」 ➜ AI 实施修改,跑通项目既有测试,附带终端真实通过凭证交付。
此例显式调用 /spot-plan,按一次确认处理;日常直接要求同样的局部文案修改可走轻量路径。高风险需求需先确认需求,再确认拟议 diff;发布与生产操作另按发布规则授权。
个人跨项目共用可安装到全局(Codex / Claude Code / Antigravity)。需要 Node.js 22+ 和 Git;以下命令可从任意目录运行,无需克隆仓库。公共规则和工具统一更新,项目只保留业务要求。详见全局安装与旧项目迁移。
# 按使用的客户端选择一条;也可同时指定多个客户端
npx --yes --allow-git=root github:hopkinson/spotter codex --global
npx --yes --allow-git=root github:hopkinson/spotter claude-code --global
npx --yes --allow-git=root github:hopkinson/spotter antigravity-cli --global
# 后续统一更新
npx --yes --allow-git=root github:hopkinson/spotter --global在目标项目根目录按客户端运行(依赖 Node 22+ / Git):
# Codex(重启后使用 $spot-plan)
npx --yes --allow-git=root github:hopkinson/spotter codex
# Claude Code / Antigravity CLI(重启后使用 /spot-plan)
npx --yes --allow-git=root github:hopkinson/spotter claude-code
npx --yes --allow-git=root github:hopkinson/spotter antigravity-cli安装后开新会话,确认 spot-plan 等入口可见,并请助手核对公共规则和内部辅助文件是否实际加载。入口可见不代表规则已加载。
注:Codex 环境使用
$前缀(如$spot-plan)。各命令状态机流转与证据阶梯详见 工作流全景规范。
| 你想做什么(日常说法) | 对应命令 | 核心交付物(看得到的凭据) |
|---|---|---|
| 加个导出功能 | /spot-plan | 改前改后草图 + 拟议核心 diff,确认后开工 |
| 修一下登录超时 | /spot-bug | 复现调用链路 + 单点失败回归用例与修复 diff |
| 理一下这个功能 | /spot-trace | 交互状态流图 + 精确代码符号清单(只读) |
| 帮我看看改动 | /spot-review | [Blocker] / [Nit] 清单,指出冗余及最小修复建议(只读) |
| 阶段风险审计 | /spot-audit | 隐性漏洞与测试缺口排查(只读) |
| 代码体检 / 闲置清理 | /spot-refactor | 死代码与孤立文件清单 + 守护测试断言 |
| 准备发布 / 部署 | /spot-release | 预检凭证,授权后推送并盯部署 |
| 建个代码图谱 | /spot-graph | 增量知识图谱,提交后自动刷新 |
| 沉淀开发经验 | /spot-learn | 可复用规则草案,确认后写入项目规则或全局偏好 |
| 写本周周报 | /spot-weekly | 进度周报草稿,按自然周或 --limit 天数汇总 Git 进展 |
| 升级随包技能 | /spot-update | 上游版本与许可检查,确认后升级 |
按安装方式选择命令;全局操作加 --global,项目操作在目标项目根目录执行。
更新已安装的工具:
# 全局安装
npx --yes --allow-git=root github:hopkinson/spotter --global
# 项目安装
npx --yes --allow-git=root github:hopkinson/spotter移除前先关闭手动启用的图谱刷新、前端 hook 或快捷方式,再运行:
# 全局安装
npx --yes --allow-git=root github:hopkinson/spotter --global --remove
# 项目安装
npx --yes --allow-git=root github:hopkinson/spotter --remove移除命令仅清理对应安装记录中的工具和规则标记段,保留个人规则正文及项目数据。全局安装不会自动移除旧项目副本;迁移需逐项目核对。指定版本、处理冲突和中断恢复见 安装说明。
欢迎提 Issue 和 PR。npm test 检查打包与安装脚本,可用 工作流回放案例 检查助手行为。
Spotter 是助手加载的协作规则与工具,执行效果取决于助手是否加载并遵守它们。缺少测试、构建或浏览器条件时,应明确报告验证缺口,不能把未验证的结果说成通过。
本项目使用 MIT 许可证。bundled-skills/ 中的第三方技能保留各自原许可,来源和版本见 第三方技能来源。
This repo does not document an install step we could read. Check the README on GitHub.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/-5 to learn what the "按使用的客户端选择一条;也可同时指定多个客户端" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/-5)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "-5" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.