@@ -0,0 +1,83 @@
1+---
2+name: agent-transcript
3+description: "Add a redacted agent transcript section to GitHub PR or issue bodies during OpenClaw agent-created PR/issue workflows."
4+---
5+6+# Agent Transcript
7+8+Best-effort local-only provenance for OpenClaw PR/issue bodies. Use during agent-created GitHub PR or issue workflows before creating/updating the body.
9+10+## Contract
11+12+- Never use network. Session discovery reads local agent logs only.
13+- Never upload raw logs. Render sanitized Markdown first.
14+- Always ask the user before adding transcript logs to a GitHub PR/issue body.
15+- Tell the user sanitized session logs help reviewers and can make PRs easier to prioritize.
16+- Offer a local HTML preview before insertion. If the user wants preview, open it and wait for confirmation before adding the section.
17+- Fail closed on unresolved secrets, private keys, browser/session/cookie details, or auth URLs.
18+- Drop system/developer prompts, raw tool outputs, reasoning, env, cookies, tokens, and broad local paths.
19+- Keep user prompts, assistant visible decisions, terse tool summaries, and test/proof outcomes.
20+- Best effort only: PR/issue creation must continue if no safe transcript is found.
21+- Use a collapsed `<details>` section and update existing markers instead of duplicating sections.
22+23+## Helper
24+25+```bash
26+.agents/skills/agent-transcript/scripts/agent-transcript --help
27+```
28+29+Find a likely local session:
30+31+```bash
32+.agents/skills/agent-transcript/scripts/agent-transcript find \
33+ --query "$PR_TITLE $BRANCH_OR_PR_URL" \
34+ --cwd "$PWD" \
35+ --since-days 14
36+```
37+38+Render a PR/issue body section:
39+40+```bash
41+.agents/skills/agent-transcript/scripts/agent-transcript render \
42+ --session "$SESSION_JSONL" \
43+ --out /tmp/agent-transcript.md
44+```
45+46+Preview one candidate session locally:
47+48+```bash
49+.agents/skills/agent-transcript/scripts/agent-transcript preview \
50+ --session "$SESSION_JSONL" \
51+ --out /tmp/agent-transcript-preview.html
52+open /tmp/agent-transcript-preview.html
53+```
54+55+Append/update a body file before `gh pr create --body-file` or connector PR creation:
56+57+```bash
58+.agents/skills/agent-transcript/scripts/agent-transcript append-body \
59+ --body /tmp/pr-body.md \
60+ --session "$SESSION_JSONL" \
61+ --out /tmp/pr-body.with-transcript.md
62+```
63+64+## PR/Issue Workflow
65+66+1. Draft the normal PR/issue body first.
67+2. Run `find` with title, branch, PR URL/number if known, and cwd.
68+3. If a high-confidence session is found, ask:
69+`Include a redacted agent transcript? It helps reviewers and can make the PR easier to prioritize. I can open a local preview first.`
70+4. If the user wants preview, run `preview`, open the HTML with `open`, and wait for confirmation.
71+5. If the user approves, run `append-body`.
72+6. Use the enriched body file for creation/update.
73+7. If no safe session is found, say nothing and continue without transcript. If the user declines, continue without transcript.
74+75+## Review Artifacts
76+77+For manual audits across many PR/session candidates, create a local HTML preview from a local JSON file. This is for maintainers only and is not part of the PR/issue workflow:
78+79+```bash
80+.agents/skills/agent-transcript/scripts/agent-transcript html \
81+ --prs /tmp/recent-prs.json \
82+ --out /tmp/agent-transcript-preview.html
83+```
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。