{
 "schema": "aiblocks-page/1",
 "id": "prepare-private-bug-evidence-for-developers",
 "type": "agent",
 "name": "Private bug evidence assistant",
 "summary": "Turn rough bug notes and a screenshot into a developer-ready bug report. You get a privacy checklist and a list of files that are safe to share.",
 "headline": "Private bug evidence assistant",
 "subhead": "Give your bug notes and a screenshot. On your own computer with masking tools, it masks a copy and checks it. In a cloud chat, bring a copy you already redacted. You get a draft issue, a privacy checklist and a list of safe files.",
 "job": {
  "id": "build-software",
  "name": "Build and ship software"
 },
 "level": "advanced",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "image",
   "required": true,
   "label": "Image",
   "what": "a finished picture"
  },
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  },
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  },
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "BUG_NOTES: give expected and observed behavior, environment and actions already tried.",
  "EVIDENCE_FILES: give a local path for original images to local masking tools. In a cloud chat, attach only already-redacted copies; never upload raw sensitive images. Identify any remaining sensitive regions.",
  "SHARING_BOUNDARY: name intended recipient and public/private issue destination.",
  "TOOL_SCOPE: state local privacy-mask/Tesseract availability and image-processing permission."
 ],
 "you_get": [
  "Reviewed redacted copies when local masking tools are available",
  "A draft issue with environment, steps, expected and actual behaviour, impact and repro limits",
  "A proofreading checklist and a safe-file list",
  "Open reproduction questions for the reporter or product owner",
  "A sharing gate marked PASS, FAIL or NOT RUN"
 ],
 "use_when": [
  "You need to post a bug in a shared or public tracker and your screenshot has private details in it.",
  "Your bug notes are rough and you want a report a developer can follow.",
  "You want a record of which images are safe to share and which were never checked."
 ],
 "skip_when": [
  "You have only a raw screenshot and a cloud chat: mask it on your own computer first, then bring the redacted copy here.",
  "The evidence is already cleared to share: write the issue straight in your tracker, no privacy review needed.",
  "A real password, key or token was exposed: send it to your own incident process and rotate it, do not paste it here.",
  "You want the issue posted for you: it drafts only, and you post it yourself."
 ],
 "output_sample": {
  "input": [
   "Your bug notes: what you expected, what happened, your setup and what you already tried",
   "Your screenshot files, as a local path or as redacted copies only",
   "Who will read the issue, and whether the place you post it is public or private",
   "Which local tools you have, such as a privacy mask tool and Tesseract, and if image work is allowed"
  ],
  "prerequisites": [
   "Local masking tools on your computer if you want the AI to mask originals (screenshot-privacy-masker, Tesseract)",
   "Without tools, a redacted copy of each image that you made yourself"
  ],
  "output": [
   {
    "name": "Draft issue",
    "contains": "A Markdown bug report with environment, steps, expected and actual behavior, impact and limits on how sure the repro is."
   },
   {
    "name": "Safe-output manifest and status",
    "contains": "A list of each safe image copy, how it links to its original, and whether its pixels were reviewed."
   },
   {
    "name": "Proofreading checklist",
    "contains": "Wording fixes as Original, Suggestion and Reason, with uncertain facts marked [verify]."
   },
   {
    "name": "Unanswered reproduction questions",
    "contains": "Open questions for the reporter or product owner, such as missing expected behavior."
   },
   {
    "name": "Sharing gate",
    "contains": "A pass, fail or not-run status for the privacy checks before you share the issue."
   }
  ]
 },
 "how_to_use": [
  "Download the pack and unzip it. Give the folder to your AI and start with START_HERE.txt.",
  "Give your bug notes: what you expected, what happened, your setup and what you tried. Say who will read the issue and whether the tracker is public or private.",
  "Pick one path for the screenshot. On your own computer with a privacy mask tool and Tesseract, give the file path and the AI masks a copy. In a cloud chat or without tools, attach only a copy you already redacted.",
  "Read the sharing gate. PASS means the checks that ran passed. FAIL means fix it and run again. NOT RUN means a check, such as the pixel review, did not happen, so do not share that image.",
  "Check the masked copy yourself against the place you will post. Automatic masking is never complete.",
  "Next, send the draft to the reporter or product owner to answer the open questions. Then post it yourself in the tracker you named. The assistant posts nothing."
 ],
 "checks": [
  "Originals remain intact and safe copies have clear identity.",
  "Actual output pixels are reviewed or review stays NOT RUN.",
  "Claims separate observed, reported and inferred behavior.",
  "Nothing is uploaded or published."
 ],
 "steps": [
  {
   "position": 1,
   "id": "screenshot-privacy-masker",
   "name": "Screenshot privacy masker",
   "summary": "Mask phone numbers, emails, keys and IDs in a screenshot on your own computer. Check the masked copy before you share it.",
   "url": "https://useaiblocks.com/skills/screenshot-privacy-masker"
  },
  {
   "position": 2,
   "id": "bug-report-writer",
   "name": "Bug report writer",
   "summary": "Turn logs, screenshots, or rough notes into a GitHub issue draft with steps and impact.",
   "url": "https://useaiblocks.com/skills/bug-report-writer"
  },
  {
   "position": 3,
   "id": "technical-doc-proofreader",
   "name": "Technical doc proofreader",
   "summary": "Share an English technical document. Get specific language fixes and fact-check flags without a full rewrite.",
   "url": "https://useaiblocks.com/skills/technical-doc-proofreader"
  }
 ],
 "next": [
  {
   "name": "Work ticket writer",
   "url": "https://useaiblocks.com/skills/work-ticket-writer",
   "why": "Build it"
  },
  {
   "name": "Bug root cause finder",
   "url": "https://useaiblocks.com/skills/bug-root-cause-finder",
   "why": "Bug root cause finder"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/practice-case.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/prepare-private-bug-evidence-for-developers",
  "markdown": "https://useaiblocks.com/agents/prepare-private-bug-evidence-for-developers.md",
  "json": "https://useaiblocks.com/agents/prepare-private-bug-evidence-for-developers.json",
  "instructions": "https://useaiblocks.com/skills/prepare-private-bug-evidence-for-developers/SKILL.md",
  "download": "https://useaiblocks.com/skills/prepare-private-bug-evidence-for-developers.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/prepare-private-bug-evidence-for-developers",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/prepare-private-bug-evidence-for-developers",
  "mcp": "https://useaiblocks.com/mcp"
 }
}