使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/reticlehq/reticle --skill fix-what-i-pointed-at开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
The human pointed at the bug. Go fix it.
"The spacing on that card is wrong" is unactionable in chat and precise in the app. Reticle's running app has a Flag a bug control: the human clicks it, points at an element, and types what is wrong. Each flag becomes a mark carrying the element, the note, and the file:line, so the round trip that usually costs a screenshot, a description, and two clarifying questions costs one call.
Not installed? RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init, then the `install-and-verify` skill.
Drain the marks
reticle_session({ action: "review", sessionId }){
"marks": [
{
"id": "m1",
"note": "this button is misaligned",
"label": "button \"Pay\"",
"source": { "file": "src/Checkout.tsx", "line": 42 },
"fix": "Open src/Checkout.tsx:42 and fix: this button is misaligned."
}
],
"pendingCount": 1
}Check this at the start of a session, and again whenever the human has been in the app. Reading never consumes a mark, so list → fix → verify → resolve is safe to run in any order.
The loop
- Read the marks. Group them if several point at the same file: one edit often answers three.
- Open
source.fileatsource.line. This is the whole point: no hunting for which component rendered that button. - Fix what the
noteasks for. If the note is ambiguous, the element label and its source usually disambiguate it. Ask the human only when they genuinely do not. - Verify in the app, do not eyeball it. Re-drive the affected control with
reticle_act_and_waitand name the consequence, orreticle_look { action: "element" }on the element for a layout or theme complaint. A visual fix confirmed by looking at it is how the mark gets reopened. - Resolve it:
reticle_session({ action: "review", sessionId, resolve: "m1" })Resolve only after the fix is verified. A resolved mark is a promise to the human that the thing they pointed at is done.
When you cannot fix one
Say so against that mark and leave it unresolved. A mark silently dropped is worse than an open one: the human believes it was handled and finds out later. If the note describes intended behaviour rather than a bug, say that too, and let them decide.
Report back in their vocabulary
They pointed at "that button". Report on "the Pay button on checkout", with what you changed and the evidence it now works. Marks come from people who are looking at the screen, not at the repo, so a report full of file paths and no user-facing language answers the wrong question.
Everything else: curl https://docs.reticle.sh/llms.txt. If a mark arrived without a usable source pointer, that is worth a reticle_feedback with kind: "gap".




