VasanthandClaude Opus 5.5
b35796e1a5
The skill is now one SKILL.md (54 lines) with the SOP shape inline, plus templates/to_docx.py for the Word and PDF. Removed: the template, the MEK reference example and the skill README. The converter's selfcheck uses a built-in sample. Tests now check the skill is that one short file, has the 6 don't-miss checks, and its SOP shape has the 5 sections and To/CC lines. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.4 KiB
3.4 KiB
name, description
| name | description |
|---|---|
| rpa-bot-handoff | Writes "<Project Name> Handover SOP" - a short PDF (at most 4 pages) that ops keeps open while running an RPA bot - how to run it, what shows where, the result, what to do when something goes wrong, and who to email (developer in To, manager in CC). Reads the code, never runs the bot. Use when the user asks to "hand over a bot", "document a bot for ops", "write a handover doc", "handover SOP", "ops guide", "runbook" or "operator guide". |
RPA bot handoff
Make <Project Name> Handover SOP: one PDF, at most 4 pages, that ops keeps open while they run the bot. Plain words, no code.
- Scan. One read-only subagent (never run the bot; no patient data, client names or passwords in its report). Ask for exact on-screen text with file:line: how to start (URL or shortcut, sign-in, Run button, what a new run does to old results), what shows where during a run, every timeout and retry, how a run ends and where the result is, every message ops can see, alerts, how to stop.
- Ask once: the developer's email (To), the manager's name and email (CC), and where ops runs it if unclear.
- Write
HANDOVER-SOP.mdin this shape:
# <Project Name> Handover SOP
Version <x> · <date> · Problems: email <developer>, CC <manager> (section 5)
<one line: what the bot does, from which app, what it produces>
## 1. How to run
Numbered steps: URL or shortcut, sign in, the Run button. Then "Before you click": what a new run does to the old results; one run at a time.
## 2. What you see while it runs
| Where on the screen | What it shows | then a normal run in one line
| Step | The bot waits at most | Then | then "Step in only when: ..."
## 3. Result
Good run / Needs a look (call out a misleading "Finished" or green). Where the result is.
| Status | Meaning | What you do |
## 4. When something goes wrong
How it shows (colour, list, column). Then:
| ID | Message you see | What it means | What you do | E01, E02 ... one row per message
Don't: (at most 3, with a short reason). To stop it: (the one right way).
## 5. Email us
Email <developer> with <manager name> (<manager email>) in CC when section 4 says "email us". Answer: <time>.
To: <developer>
CC: <manager>
Subject: <Project Name> - E<number> - <date>
Run started / Error: E<number> - <message> / Where / What I did / Attached: screenshot
Never send: passwords, patient data, result files that hold patient data.
- Build:
python <skill>/templates/to_docx.py HANDOVER-SOP.md -o "<Project Name> Handover SOP.docx" --pdf. Over 4 pages: shorten cells, never drop a message. - Hand over the PDF. Problems for the dev team go in the chat (at most 5 lines), not in the SOP.
Rules
- Copy every label and message exactly from the code; variable parts in italics ("Couldn't download Location").
- Every wait is a number. Say plainly when the screen misleads.
- One row per message, one short line per cell.
- No file names, code, settings names, patient data, client names or passwords.
Don't miss: check each of these and cover every one that applies in section 3 or 4:
- Setup missing: login, file, driver. Which message shows?
- The app or portal is slow or changed: timeouts, "not found".
- Names in the input or mapping don't match the target app.
- Says done but isn't, or did it but says failed: tell ops to check before re-running.
- Stuck, can't be stopped, or blocks the next run.
- The cause is only in a raw log, or there is no alert.