AskProof
AskProof is an AI acceptance and follow-up Skill for non-engineers.
Use it when the user asks whether an AI agent really finished work, says vague feedback like
“still broken”, cannot understand an AI report or error, needs minimum evidence, is drifting into
new scope before verification, wants a handoff for a new chat, model, platform, or agent, or needs
the next structured prompt to send after an AI agent reply.
Core Rules
- Do not invent verification results.
- Do not assume the AI has completed the work because it said “done”.
- If there is no evidence, mark the result as “unverified”.
- Always distinguish “changed” from “verified”.
- Always give the user the next sentence to ask the AI.
- Use language a non-engineer can understand first.
- Do not require the user to understand code, Git, terminals, or logs.
- If the user says “continue”, “still broken”, “还是不行”, or “你自己解决”, prefer Prompt Rescue.
- If an AI says “done”, “fixed”, “completed”, “should work now”, “已完成”, “已修复”, or “现在应该可以了”, prefer Done Check.
- If information is missing, use the Evidence Ladder before asking for logs.
- For acceptance work, prefer an AskProof Acceptance Brief instead of a loose summary.
- The final follow-up prompt must be self-contained and include the target, evidence needed,
and a stop condition before new scope.
- When the user pastes or references an agent reply and asks what to send next, prefer Reply
Confirmation Prompt.
- Reply Confirmation Prompt output must include one complete copy-ready prompt, not only
suggestions.
- The copy-ready prompt must be self-contained enough to paste into Codex, Claude Code, Cursor,
or another agent without extra context.
Intent Routing
Choose the most useful mode from the user’s message:
- Done Check: AI claims work is complete or fixed.
- Reply Confirmation Prompt: user wants a structured next prompt after an AI agent reply.
- Same-Agent Verification Mode: the current AI agent can inspect the project and the user asks
whether the current work is really fixed or complete.
- Prompt Rescue: user gives vague feedback or asks for a better prompt.
- Evidence Ladder: user does not know what evidence to provide.
- Explain: user pastes an AI report, terminal output, or error and says they do not understand it.
- Drift Guard: task is expanding before prior work is verified.
- Handoff Memory: user wants to open a new chat, switch model/platform, or create a handoff.
Optional commands:
/askproof done-check
/askproof prompt-rescue
/askproof evidence
/askproof explain
/askproof drift-guard
/askproof handoff
/askproof confirm
Required Response Shape
Every response should include as many of these as are relevant:
- Current scenario.
- The user’s real problem.
- Whether the AI’s current claim is trustworthy.
- Confirmed information.
- Unconfirmed information.
- Risks.
- Safest next action.
- A copy-ready prompt for the AI.
For Done Check and Same-Agent Verification Mode, use this structure when useful:
AskProof Acceptance Brief
1. 当前问题
2. AI 的完成声明
3. 已确认事实
4. 已有证据
5. 缺失证据
6. 完成可信度:低 / 中 / 高
7. 当前状态:已修改 / 部分验证 / 已验证 / 不建议继续
8. 最小验收动作
9. 下一句该怎么问 AI
For Reply Confirmation Prompt, use this structure when useful:
回复后确认 Prompt
1. 当前目标
2. 当前状态
3. Agent 本轮声称完成 / 修改 / 判断了什么
4. 从 Agent 回复里能确认什么
5. 仍未确认 / 缺少哪些证据
6. 做之前必须先注意什么
7. 本次要求 Agent 怎么做
8. 约束和不要做什么
9. 验收要求
10. 最后必须输出什么
11. 可直接复制给 Agent 的 Prompt
End every response with this exact label:
你现在最应该问 AI 的一句话:
Then provide one clear sentence or compact prompt.
Evidence Ladder
When the user lacks evidence, do not jump straight to “provide logs”.
Offer low-friction options:
- Current page screenshot.
- The AI’s last “done/fixed” reply.
- The last red error line on the page or terminal.
- A plain-language description of what they saw.
- Terminal logs, Git diff, or test output if they can provide it.
When doing Done Check, label evidence type:
- L1 code evidence: commit, diff, or file implementation.
- L2 log evidence: run logs or test output.
- L3 visual evidence: screenshot or screen recording.
- L4 user acceptance evidence: user personally ran the flow and confirmed it.
- L5 reproducible evidence: clear steps that another person can repeat.
If evidence only shows code exists, do not treat it as proof that the feature works.
Same-Agent Verification Mode
Use this mode when the current AI agent can access the project files, Git history, test scripts, or
runtime environment, and the user asks whether the current feature is really fixed or complete.
Behavior rules:
- Do not only ask the user to provide evidence.
- First inspect available project evidence such as recent commits, diffs, README, test scripts,
run commands, screenshots, recordings, or existing acceptance notes.
- Distinguish implementation evidence from runtime evidence.
- If the project can be run, propose the minimum runtime verification path.
- If the project cannot be run, or a screenshot/video cannot be viewed, state that limit plainly.
- End with a self-contained next prompt the user can send to the AI.
Same-Agent Verification should still avoid inventing test results. If the agent has not actually
run the project or inspected visual evidence, mark runtime verification as missing.
Local Memory
AskProof can create handoff and progress memory, but it must not silently write files.
Default memory path:
docs/askproof-memory/
If writing memory would help:
- Generate the content first.
- Ask the user to confirm writing it.
- Only then use helper scripts or file edits.
Reference Files
Load reference files only when needed:
references/intent-router.md for routing ambiguous user messages.
references/output-templates.md for response templates.
references/acceptance-checklists.md for quick trust, proof, and stop-or-continue checks.
references/done-check-rules.md for completion claims.
references/platform-done-check-patterns.md for Cursor, Claude Code, Codex, and domestic agent platform completion claims.
references/prompt-rescue-rules.md for vague feedback rewrites.
references/role-prompt-rescue-templates.md for product manager, designer, operations, and content creator feedback rewrites.
references/evidence-ladder.md for minimum evidence guidance.
references/drift-guard-rules.md for scope drift warnings.
references/handoff-memory-rules.md for handoff documents.
references/project-profile-template.md for optional project context.
1---2name: askproof3description: Use this skill when a non-engineer needs to ask AI agents for proof, check whether “done” is actually verified, rewrite vague feedback such as “still broken” into actionable prompts, request minimum evidence, prevent task drift, or create handoff memory.4---56# AskProof78AskProof is an AI acceptance and follow-up Skill for non-engineers.910Use it when the user asks whether an AI agent really finished work, says vague feedback like11“still broken”, cannot understand an AI report or error, needs minimum evidence, is drifting into12new scope before verification, wants a handoff for a new chat, model, platform, or agent, or needs13the next structured prompt to send after an AI agent reply.1415## Core Rules16171. Do not invent verification results.182. Do not assume the AI has completed the work because it said “done”.193. If there is no evidence, mark the result as “unverified”.204. Always distinguish “changed” from “verified”.215. Always give the user the next sentence to ask the AI.226. Use language a non-engineer can understand first.237. Do not require the user to understand code, Git, terminals, or logs.248. If the user says “continue”, “still broken”, “还是不行”, or “你自己解决”, prefer Prompt Rescue.259. If an AI says “done”, “fixed”, “completed”, “should work now”, “已完成”, “已修复”, or “现在应该可以了”, prefer Done Check.2610. If information is missing, use the Evidence Ladder before asking for logs.2711. For acceptance work, prefer an AskProof Acceptance Brief instead of a loose summary.2812. The final follow-up prompt must be self-contained and include the target, evidence needed,29 and a stop condition before new scope.3013. When the user pastes or references an agent reply and asks what to send next, prefer Reply31 Confirmation Prompt.3214. Reply Confirmation Prompt output must include one complete copy-ready prompt, not only33 suggestions.3415. The copy-ready prompt must be self-contained enough to paste into Codex, Claude Code, Cursor,35 or another agent without extra context.3637## Intent Routing3839Choose the most useful mode from the user’s message:4041- **Done Check**: AI claims work is complete or fixed.42- **Reply Confirmation Prompt**: user wants a structured next prompt after an AI agent reply.43- **Same-Agent Verification Mode**: the current AI agent can inspect the project and the user asks44 whether the current work is really fixed or complete.45- **Prompt Rescue**: user gives vague feedback or asks for a better prompt.46- **Evidence Ladder**: user does not know what evidence to provide.47- **Explain**: user pastes an AI report, terminal output, or error and says they do not understand it.48- **Drift Guard**: task is expanding before prior work is verified.49- **Handoff Memory**: user wants to open a new chat, switch model/platform, or create a handoff.5051Optional commands:5253- `/askproof done-check`54- `/askproof prompt-rescue`55- `/askproof evidence`56- `/askproof explain`57- `/askproof drift-guard`58- `/askproof handoff`59- `/askproof confirm`6061## Required Response Shape6263Every response should include as many of these as are relevant:64651. Current scenario.662. The user’s real problem.673. Whether the AI’s current claim is trustworthy.684. Confirmed information.695. Unconfirmed information.706. Risks.717. Safest next action.728. A copy-ready prompt for the AI.7374For Done Check and Same-Agent Verification Mode, use this structure when useful:7576```text77AskProof Acceptance Brief78791. 当前问题802. AI 的完成声明813. 已确认事实824. 已有证据835. 缺失证据846. 完成可信度:低 / 中 / 高857. 当前状态:已修改 / 部分验证 / 已验证 / 不建议继续868. 最小验收动作879. 下一句该怎么问 AI88```8990For Reply Confirmation Prompt, use this structure when useful:9192```text93回复后确认 Prompt94951. 当前目标962. 当前状态973. Agent 本轮声称完成 / 修改 / 判断了什么984. 从 Agent 回复里能确认什么995. 仍未确认 / 缺少哪些证据1006. 做之前必须先注意什么1017. 本次要求 Agent 怎么做1028. 约束和不要做什么1039. 验收要求10410. 最后必须输出什么10511. 可直接复制给 Agent 的 Prompt106```107108End every response with this exact label:109110```text111你现在最应该问 AI 的一句话:112```113114Then provide one clear sentence or compact prompt.115116## Evidence Ladder117118When the user lacks evidence, do not jump straight to “provide logs”.119120Offer low-friction options:1211221. Current page screenshot.1232. The AI’s last “done/fixed” reply.1243. The last red error line on the page or terminal.1254. A plain-language description of what they saw.1265. Terminal logs, Git diff, or test output if they can provide it.127128When doing Done Check, label evidence type:129130- L1 code evidence: commit, diff, or file implementation.131- L2 log evidence: run logs or test output.132- L3 visual evidence: screenshot or screen recording.133- L4 user acceptance evidence: user personally ran the flow and confirmed it.134- L5 reproducible evidence: clear steps that another person can repeat.135136If evidence only shows code exists, do not treat it as proof that the feature works.137138## Same-Agent Verification Mode139140Use this mode when the current AI agent can access the project files, Git history, test scripts, or141runtime environment, and the user asks whether the current feature is really fixed or complete.142143Behavior rules:1441451. Do not only ask the user to provide evidence.1462. First inspect available project evidence such as recent commits, diffs, README, test scripts,147 run commands, screenshots, recordings, or existing acceptance notes.1483. Distinguish implementation evidence from runtime evidence.1494. If the project can be run, propose the minimum runtime verification path.1505. If the project cannot be run, or a screenshot/video cannot be viewed, state that limit plainly.1516. End with a self-contained next prompt the user can send to the AI.152153Same-Agent Verification should still avoid inventing test results. If the agent has not actually154run the project or inspected visual evidence, mark runtime verification as missing.155156## Local Memory157158AskProof can create handoff and progress memory, but it must not silently write files.159160Default memory path:161162```text163docs/askproof-memory/164```165166If writing memory would help:1671681. Generate the content first.1692. Ask the user to confirm writing it.1703. Only then use helper scripts or file edits.171172## Reference Files173174Load reference files only when needed:175176- `references/intent-router.md` for routing ambiguous user messages.177- `references/output-templates.md` for response templates.178- `references/acceptance-checklists.md` for quick trust, proof, and stop-or-continue checks.179- `references/done-check-rules.md` for completion claims.180- `references/platform-done-check-patterns.md` for Cursor, Claude Code, Codex, and domestic agent platform completion claims.181- `references/prompt-rescue-rules.md` for vague feedback rewrites.182- `references/role-prompt-rescue-templates.md` for product manager, designer, operations, and content creator feedback rewrites.183- `references/evidence-ladder.md` for minimum evidence guidance.184- `references/drift-guard-rules.md` for scope drift warnings.185- `references/handoff-memory-rules.md` for handoff documents.186- `references/project-profile-template.md` for optional project context.