autopilot-comment

autopilot-comment -- Sole GitHub comment writer

Any autopilot skill that would write a GitHub comment loads this skill in the same session and stops if the card is missing. Do not spawn a nested session. Do not comment from the caller.

Activation card

activation_card: on. Before any GitHub comment write, emit this Enter card with every field filled. Missing field -> stop.

skill: autopilot-comment
skill_path: <resolved directory of this SKILL.md>
mode: run
subject: microsoft/apm#<number>
path: comment
intent: post one GitHub comment | patch one GitHub comment
origin: unattended | actor-session
write: on | off
debug: off | on
repo: microsoft/apm
target_kind: issue | pull
target: <positive integer>
source_skill: <canonical autopilot skill name>
comment_id: none | <positive integer>
invocation: agentic-workflow | actor-session
receipt: <HTML comment watermark line>
public_body: <author-facing prose, no JSON, no footer>
debug_body: <full internal template without JSON fence, or none>

Rules:

• write defaults to on when the caller omitted it.
• write: off returns the assembled body only. Do not post or patch.
• write: on posts or patches exactly one comment. Never labels, assigns, requests reviewers, or merges.
• debug defaults to off when omitted or unknown. Omitted debug is not a missing-field stop.
• debug: off -> HTML receipt plus public_body. Do not post internal headings from debug_body.
• debug: on -> first line [i] Skill debug is on. then receipt plus debug_body (or public_body if debug_body is none).
• comment_id: none with intent post. A numeric comment_id with intent patch. Mismatch -> stop.
• source_skill is the caller (for example autopilot-issue-triage-worker). Never autopilot-comment.
• origin fail-closed unknown -> unattended.
• Strip any JSON fence from bodies before assembly. Never post JSON on GitHub.

After the write (or dry-run), emit this Exit receipt:

skill: autopilot-comment
subject: microsoft/apm#<number>
path: comment
write: on | off
debug: off | on
posted: yes | no
patched: yes | no
comment_id: <id or none>
source_skill: <canonical autopilot skill name>
approved: n/a

Assemble

1. Drop JSON fences and triage-recommendation blocks.
2. Build the body from debug as above. ASCII only.
3. Append this exact footer, substituting source_skill:

---

Generated by <source_skill>. This comment is AI-generated and may contain errors.

4. If the footer is already the last lines, do not duplicate it.

Write

Actor-session / Copilot App / Cloud / Remote:

• issue + post: gh issue comment <target> --body-file ...
• pull + post: gh pr comment <target> --body-file ...
• patch: gh api -X PATCH /repos/microsoft/apm/issues/comments/<comment_id>

Agentic Workflow: safe-outputs.add-comment for post. Patch is not available; stop if intent is patch.

One comment per activation. No progress comments.

Hard nos

• Do not assign, request reviewers, merge, or edit labels.
• Do not implement.
• Do not compose schedulers or other workers.
• ASCII only.