[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M719DVVDPYM5Y183HPHCQBAV":3,"skill-same:01M719DVVDPYM5Y183HPHCQBAV":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":68,"commitSha":69,"skillDirectory":70,"forksCount":71,"repositoryHtmlUrl":72,"repositoryHomepageUrl":6,"ownerHtmlUrl":73,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":74,"install":75,"resources":88},"01M719DVVDPYM5Y183HPHCQBAV","external-comms",null,"PAO workflow for scanning, drafting, and presenting community responses with human review gate","DeDuva\u002Fsquad","DeDuva","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8153108?v=4","01M719BQB25861D0TKS3RVHMN2","01M719BQBSWR380PSYDD5M9YD4",1,"MIT","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002F.squad\u002Fskills\u002Fexternal-comms\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"external comms","comms","mcp-server","server","communications","review","api","candidate","drafting","issue list","workflow","when","workflows","MCP","open","labels","issues","search","community","coverage","2026-11-10 10:12:30",false,"---\r\nname: \"external-comms\"\r\ndescription: \"PAO workflow for scanning, drafting, and presenting community responses with human review gate\"\r\ndomain: \"community, communication, workflow\"\r\nconfidence: \"low\"\r\nsource: \"manual (RFC #426 — PAO External Communications)\"\r\ntools:\r\n  - name: \"github-mcp-server-list_issues\"\r\n    description: \"List open issues for scan candidates and lightweight triage\"\r\n    when: \"Use for recent open issue scans before thread-level review\"\r\n  - name: \"github-mcp-server-issue_read\"\r\n    description: \"Read the full issue, comments, and labels before drafting\"\r\n    when: \"Use after selecting a candidate so PAO has complete thread context\"\r\n  - name: \"github-mcp-server-search_issues\"\r\n    description: \"Search for candidate issues or prior squad responses\"\r\n    when: \"Use when filtering by keywords, labels, or duplicate response checks\"\r\n  - name: \"gh CLI\"\r\n    description: \"Fallback for GitHub issue comments and discussions workflows\"\r\n    when: \"Use gh issue list\u002Fcomment and gh api or gh api graphql when MCP coverage is incomplete\"\r\n---\r\n\r\n## Context\r\n\r\nPhase 1 is **draft-only mode**.\r\n\r\n- PAO scans issues and discussions, drafts responses with the humanizer skill, and presents a review table for human approval.\r\n- **Human review gate is mandatory** — PAO never posts autonomously.\r\n- Every action is logged to `.squad\u002Fcomms\u002Faudit\u002F`.\r\n- This workflow is triggered manually only (\"PAO, check community\") — no automated or Ralph-triggered activation in Phase 1.\r\n\r\n## Patterns\r\n\r\n### 1. Scan\r\n\r\nFind unanswered community items with GitHub MCP tools first, or `gh issue list` \u002F `gh api` as fallback for issues and discussions.\r\n\r\n- Include **open** issues and discussions only.\r\n- Filter for items with **no squad team response**.\r\n- Limit to items created in the last 7 days.\r\n- Exclude items labeled `squad:internal` or `wontfix`.\r\n- Include discussions **and** issues in the same sweep.\r\n- Phase 1 scope is **issues and discussions only** — do not draft PR replies.\r\n\r\n### Discussion Handling (Phase 1)\r\n\r\nDiscussions use the GitHub Discussions API, which differs from issues:\r\n\r\n- **Scan:** `gh api \u002Frepos\u002F{owner}\u002F{repo}\u002Fdiscussions --jq '.[] | select(.answer_chosen_at == null)'` to find unanswered discussions\r\n- **Categories:** Filter by Q&A and General categories only (skip Announcements, Show and Tell)\r\n- **Answers vs comments:** In Q&A discussions, PAO drafts an \"answer\" (not a comment). The human marks it as accepted answer after posting.\r\n- **Phase 1 scope:** Issues and Discussions ONLY. No PR comments.\r\n\r\n### 2. Classify\r\n\r\nDetermine the response type before drafting.\r\n\r\n- Welcome (new contributor)\r\n- Troubleshooting (bug\u002Fhelp)\r\n- Feature guidance (feature request\u002Fhow-to)\r\n- Redirect (wrong repo\u002Fscope)\r\n- Acknowledgment (confirmed, no fix)\r\n- Closing (resolved)\r\n- Technical uncertainty (unknown cause)\r\n- Empathetic disagreement (pushback on a decision or design)\r\n- Information request (need more reproduction details or context)\r\n\r\n### Template Selection Guide\r\n\r\n| Signal in Issue\u002FDiscussion | → Response Type | Template |\r\n|---------------------------|-----------------|----------|\r\n| New contributor (0 prior issues) | Welcome | T1 |\r\n| Error message, stack trace, \"doesn't work\" | Troubleshooting | T2 |\r\n| \"How do I...?\", \"Can Squad...?\", \"Is there a way to...?\" | Feature Guidance | T3 |\r\n| Wrong repo, out of scope for Squad | Redirect | T4 |\r\n| Confirmed bug, no fix available yet | Acknowledgment | T5 |\r\n| Fix shipped, PR merged that resolves issue | Closing | T6 |\r\n| Unclear cause, needs investigation | Technical Uncertainty | T7 |\r\n| Author disagrees with a decision or design | Empathetic Disagreement | T8 |\r\n| Need more reproduction info or context | Information Request | T9 |\r\n\r\nUse exactly one template as the base draft. Replace placeholders with issue-specific details, then apply the humanizer patterns. If the thread spans multiple signals, choose the highest-risk template and capture the nuance in the thread summary.\r\n\r\n### Confidence Classification\r\n\r\n| Confidence | Criteria | Example |\r\n|-----------|----------|---------|\r\n| 🟢 High | Answer exists in Squad docs or FAQ, similar question answered before, no technical ambiguity | \"How do I install Squad?\" |\r\n| 🟡 Medium | Technical answer is sound but involves judgment calls, OR docs exist but don't perfectly match the question, OR tone is tricky | \"Can Squad work with Azure DevOps?\" (yes, but setup is nuanced) |\r\n| 🔴 Needs Review | Technical uncertainty, policy\u002Froadmap question, potential reputational risk, author is frustrated\u002Fangry, question about unreleased features | \"When will Squad support Claude?\" |\r\n\r\n**Auto-escalation rules:**\r\n- Any mention of competitors → 🔴\r\n- Any mention of pricing\u002Flicensing → 🔴\r\n- Author has >3 follow-up comments without resolution → 🔴\r\n- Question references a closed-wontfix issue → 🔴\r\n\r\n### 3. Draft\r\n\r\nUse the humanizer skill for every draft.\r\n\r\n- Complete **Thread-Read Verification** before writing.\r\n- Read the **full thread**, including all comments, before writing.\r\n- Select the matching template from the **Template Selection Guide** and record the template ID in the review notes.\r\n- Treat templates as reusable drafting assets: keep the structure, replace placeholders, and only improvise when the thread truly requires it.\r\n- Validate the draft against the humanizer anti-patterns.\r\n- Flag long threads (`>10` comments) with `⚠️`.\r\n\r\n### Thread-Read Verification\r\n\r\nBefore drafting, PAO MUST verify complete thread coverage:\r\n\r\n1. **Count verification:** Compare API comment count with actually-read comments. If mismatch, abort draft.\r\n2. **Deleted comment check:** Use `gh api` timeline to detect deleted comments. If found, flag as ⚠️ in review table.\r\n3. **Thread summary:** Include in every draft: \"Thread: {N} comments, last activity {date}, {summary of key points}\"\r\n4. **Long thread flag:** If >10 comments, add ⚠️ to review table and include condensed thread summary\r\n5. **Evidence line in review table:** Each draft row includes \"Read: {N}\u002F{total} comments\" column\r\n\r\n### 4. Present\r\n\r\nShow drafts for review in this exact format:\r\n\r\n```text\r\n📝 PAO — Community Response Drafts\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n| # | Item | Author | Type | Confidence | Read | Preview |\r\n|---|------|--------|------|------------|------|---------|\r\n| 1 | Issue #N | @user | Type | 🟢\u002F🟡\u002F🔴 | N\u002FN | \"First words...\" |\r\n\r\nConfidence: 🟢 High | 🟡 Medium | 🔴 Needs review\r\n\r\nFull drafts below ▼\r\n```\r\n\r\nEach full draft must begin with the thread summary line:\r\n`Thread: {N} comments, last activity {date}, {summary of key points}`\r\n\r\n### 5. Human Action\r\n\r\nWait for explicit human direction before anything is posted.\r\n\r\n- `pao approve 1 3` — approve drafts 1 and 3\r\n- `pao edit 2` — edit draft 2\r\n- `pao skip` — skip all\r\n- `banana` — freeze all pending (safe word)\r\n\r\n### Rollback — Bad Post Recovery\r\n\r\nIf a posted response turns out to be wrong, inappropriate, or needs correction:\r\n\r\n1. **Delete the comment:**\r\n   - Issues: `gh api -X DELETE \u002Frepos\u002F{owner}\u002F{repo}\u002Fissues\u002Fcomments\u002F{comment_id}`\r\n   - Discussions: `gh api graphql -f query='mutation { deleteDiscussionComment(input: {id: \"{node_id}\"}) { comment { id } } }'`\r\n2. **Log the deletion:** Write audit entry with action `delete`, include reason and original content\r\n3. **Draft replacement** (if needed): PAO drafts a corrected response, goes through normal review cycle\r\n4. **Postmortem:** If the error reveals a pattern gap, update humanizer anti-patterns or add a new test case\r\n\r\n**Safe word — `banana`:**\r\n- Immediately freezes all pending drafts in the review queue\r\n- No new scans or drafts until `pao resume` is issued\r\n- Audit entry logged with halter identity and reason\r\n\r\n### 6. Post\r\n\r\nAfter approval:\r\n\r\n- Human posts via `gh issue comment` for issues or `gh api` for discussion answers\u002Fcomments.\r\n- PAO helps by preparing the CLI command.\r\n- Write the audit entry after the posting action.\r\n\r\n### 7. Audit\r\n\r\nLog every action.\r\n\r\n- Location: `.squad\u002Fcomms\u002Faudit\u002F{timestamp}.md`\r\n- Required fields vary by action — see `.squad\u002Fcomms\u002Ftemplates\u002Faudit-entry.md` Conditional Fields table\r\n- Universal required fields: `timestamp`, `action`\r\n- All other fields are conditional on the action type\r\n\r\n## Examples\r\n\r\nThese are reusable templates. Keep the structure, replace placeholders, and adjust only where the thread requires it.\r\n\r\n### Example scan command\r\n\r\n```bash\r\ngh issue list --state open --json number,title,author,labels,comments --limit 20\r\n```\r\n\r\n### Example review table\r\n\r\n```text\r\n📝 PAO — Community Response Drafts\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n| # | Item | Author | Type | Confidence | Read | Preview |\r\n|---|------|--------|------|------------|------|---------|\r\n| 1 | Issue #426 | @newdev | Welcome | 🟢 | 1\u002F1 | \"Hey @newdev! Welcome to Squad...\" |\r\n| 2 | Discussion #18 | @builder | Feature guidance | 🟡 | 4\u002F4 | \"Great question! Today the CLI...\" |\r\n| 3 | Issue #431 ⚠️ | @debugger | Technical uncertainty | 🔴 | 12\u002F12 | \"Interesting find, @debugger...\" |\r\n\r\nConfidence: 🟢 High | 🟡 Medium | 🔴 Needs review\r\n\r\nFull drafts below ▼\r\n```\r\n\r\n### Example audit entry (post action)\r\n\r\n```markdown\r\n---\r\ntimestamp: \"2026-03-16T21:30:00Z\"\r\naction: \"post\"\r\nitem_number: 426\r\ndraft_id: 1\r\nreviewer: \"@bradygaster\"\r\n---\r\n\r\n## Context (draft, approve, edit, skip, post, delete actions)\r\n- Thread depth: 3\r\n- Response type: welcome\r\n- Confidence: 🟢\r\n- Long thread flag: false\r\n\r\n## Draft Content (draft, edit, post actions)\r\nThread: 3 comments, last activity 2026-03-16, reporter hit a preview-build regression after install.\r\n\r\nHey @newdev! Welcome to Squad 👋 Thanks for opening this.\r\nWe reproduced the issue in preview builds and we're checking the regression point now.\r\nLet us know if you can share the command you ran right before the failure.\r\n\r\n## Post Result (post, delete actions)\r\nhttps:\u002F\u002Fgithub.com\u002Fbradygaster\u002Fsquad\u002Fissues\u002F426#issuecomment-123456\r\n```\r\n\r\n### T1 — Welcome\r\n\r\n```text\r\nHey {author}! Welcome to Squad 👋 Thanks for opening this.\r\n{specific acknowledgment or first answer}\r\nLet us know if you have questions — happy to help!\r\n```\r\n\r\n### T2 — Troubleshooting\r\n\r\n```text\r\nThanks for the detailed report, {author}!\r\nHere's what we think is happening: {explanation}\r\n{steps or workaround}\r\nLet us know if that helps, or if you're seeing something different.\r\n```\r\n\r\n### T3 — Feature Guidance\r\n\r\n```text\r\nGreat question! {context on current state}\r\n{guidance or workaround}\r\nWe've noted this as a potential improvement — {tracking info if applicable}.\r\n```\r\n\r\n### T4 — Redirect\r\n\r\n```text\r\nThanks for reaching out! This one is actually better suited for {correct location}.\r\n{brief explanation of why}\r\nFeel free to open it there — they'll be able to help!\r\n```\r\n\r\n### T5 — Acknowledgment\r\n\r\n```text\r\nGood catch, {author}. We've confirmed this is a real issue.\r\n{what we know so far}\r\nWe'll update this thread when we have a fix. Thanks for flagging it!\r\n```\r\n\r\n### T6 — Closing\r\n\r\n```text\r\nThis should be resolved in {version\u002FPR}! 🎉\r\n{brief summary of what changed}\r\nThanks for reporting this, {author} — it made Squad better.\r\n```\r\n\r\n### T7 — Technical Uncertainty\r\n\r\n```text\r\nInteresting find, {author}. We're not 100% sure what's causing this yet.\r\nHere's what we've ruled out: {list}\r\nWe'd love more context if you have it — {specific ask}.\r\nWe'll dig deeper and update this thread.\r\n```\r\n\r\n### T8 — Empathetic Disagreement\r\n\r\n```text\r\nWe hear you, {author}. That's a fair concern.\r\n\r\nThe current design choice was driven by {reason}. We know it's not ideal for every use case.\r\n\r\n{what alternatives exist or what trade-off was made}\r\n\r\nIf you have ideas for how to make this work better for your scenario, we'd love to hear them — open a discussion or drop your thoughts here!\r\n```\r\n\r\n### T9 — Information Request\r\n\r\n```text\r\nThanks for reporting this, {author}!\r\n\r\nTo help us dig into this, could you share:\r\n- {specific ask 1}\r\n- {specific ask 2}\r\n- {specific ask 3, if applicable}\r\n\r\nThat context will help us narrow down what's happening. Appreciate it!\r\n```\r\n\r\n## Anti-Patterns\r\n\r\n- ❌ Posting without human review (NEVER — this is the cardinal rule)\r\n- ❌ Drafting without reading full thread (context is everything)\r\n- ❌ Ignoring confidence flags (🔴 items need Flight\u002Fhuman review)\r\n- ❌ Scanning closed issues (only open items)\r\n- ❌ Responding to issues labeled `squad:internal` or `wontfix`\r\n- ❌ Skipping audit logging (every action must be recorded)\r\n- ❌ Drafting for issues where a squad member already responded (avoid duplicates)\r\n- ❌ Drafting pull request responses in Phase 1 (issues\u002Fdiscussions only)\r\n- ❌ Treating templates like loose examples instead of reusable drafting assets\r\n- ❌ Asking for more info without specific requests\r\n","## Context\r\n\r\nPhase 1 is **draft-only mode**.\r\n\r\n- PAO scans issues and discussions, drafts responses with the humanizer skill, and presents a review table for human approval.\r\n- **Human review gate is mandatory** — PAO never posts autonomously.\r\n- Every action is logged to `.squad\u002Fcomms\u002Faudit\u002F`.\r\n- This workflow is triggered manually only (\"PAO, check community\") — no automated or Ralph-triggered activation in Phase 1.\r\n\r\n## Patterns\r\n\r\n### 1. Scan\r\n\r\nFind unanswered community items with GitHub MCP tools first, or `gh issue list` \u002F `gh api` as fallback for issues and discussions.\r\n\r\n- Include **open** issues and discussions only.\r\n- Filter for items with **no squad team response**.\r\n- Limit to items created in the last 7 days.\r\n- Exclude items labeled `squad:internal` or `wontfix`.\r\n- Include discussions **and** issues in the same sweep.\r\n- Phase 1 scope is **issues and discussions only** — do not draft PR replies.\r\n\r\n### Discussion Handling (Phase 1)\r\n\r\nDiscussions use the GitHub Discussions API, which differs from issues:\r\n\r\n- **Scan:** `gh api \u002Frepos\u002F{owner}\u002F{repo}\u002Fdiscussions --jq '.[] | select(.answer_chosen_at == null)'` to find unanswered discussions\r\n- **Categories:** Filter by Q&A and General categories only (skip Announcements, Show and Tell)\r\n- **Answers vs comments:** In Q&A discussions, PAO drafts an \"answer\" (not a comment). The human marks it as accepted answer after posting.\r\n- **Phase 1 scope:** Issues and Discussions ONLY. No PR comments.\r\n\r\n### 2. Classify\r\n\r\nDetermine the response type before drafting.\r\n\r\n- Welcome (new contributor)\r\n- Troubleshooting (bug\u002Fhelp)\r\n- Feature guidance (feature request\u002Fhow-to)\r\n- Redirect (wrong repo\u002Fscope)\r\n- Acknowledgment (confirmed, no fix)\r\n- Closing (resolved)\r\n- Technical uncertainty (unknown cause)\r\n- Empathetic disagreement (pushback on a decision or design)\r\n- Information request (need more reproduction details or context)\r\n\r\n### Template Selection Guide\r\n\r\n| Signal in Issue\u002FDiscussion | → Response Type | Template |\r\n|---------------------------|-----------------|----------|\r\n| New contributor (0 prior issues) | Welcome | T1 |\r\n| Error message, stack trace, \"doesn't work\" | Troubleshooting | T2 |\r\n| \"How do I...?\", \"Can Squad...?\", \"Is there a way to...?\" | Feature Guidance | T3 |\r\n| Wrong repo, out of scope for Squad | Redirect | T4 |\r\n| Confirmed bug, no fix available yet | Acknowledgment | T5 |\r\n| Fix shipped, PR merged that resolves issue | Closing | T6 |\r\n| Unclear cause, needs investigation | Technical Uncertainty | T7 |\r\n| Author disagrees with a decision or design | Empathetic Disagreement | T8 |\r\n| Need more reproduction info or context | Information Request | T9 |\r\n\r\nUse exactly one template as the base draft. Replace placeholders with issue-specific details, then apply the humanizer patterns. If the thread spans multiple signals, choose the highest-risk template and capture the nuance in the thread summary.\r\n\r\n### Confidence Classification\r\n\r\n| Confidence | Criteria | Example |\r\n|-----------|----------|---------|\r\n| 🟢 High | Answer exists in Squad docs or FAQ, similar question answered before, no technical ambiguity | \"How do I install Squad?\" |\r\n| 🟡 Medium | Technical answer is sound but involves judgment calls, OR docs exist but don't perfectly match the question, OR tone is tricky | \"Can Squad work with Azure DevOps?\" (yes, but setup is nuanced) |\r\n| 🔴 Needs Review | Technical uncertainty, policy\u002Froadmap question, potential reputational risk, author is frustrated\u002Fangry, question about unreleased features | \"When will Squad support Claude?\" |\r\n\r\n**Auto-escalation rules:**\r\n- Any mention of competitors → 🔴\r\n- Any mention of pricing\u002Flicensing → 🔴\r\n- Author has >3 follow-up comments without resolution → 🔴\r\n- Question references a closed-wontfix issue → 🔴\r\n\r\n### 3. Draft\r\n\r\nUse the humanizer skill for every draft.\r\n\r\n- Complete **Thread-Read Verification** before writing.\r\n- Read the **full thread**, including all comments, before writing.\r\n- Select the matching template from the **Template Selection Guide** and record the template ID in the review notes.\r\n- Treat templates as reusable drafting assets: keep the structure, replace placeholders, and only improvise when the thread truly requires it.\r\n- Validate the draft against the humanizer anti-patterns.\r\n- Flag long threads (`>10` comments) with `⚠️`.\r\n\r\n### Thread-Read Verification\r\n\r\nBefore drafting, PAO MUST verify complete thread coverage:\r\n\r\n1. **Count verification:** Compare API comment count with actually-read comments. If mismatch, abort draft.\r\n2. **Deleted comment check:** Use `gh api` timeline to detect deleted comments. If found, flag as ⚠️ in review table.\r\n3. **Thread summary:** Include in every draft: \"Thread: {N} comments, last activity {date}, {summary of key points}\"\r\n4. **Long thread flag:** If >10 comments, add ⚠️ to review table and include condensed thread summary\r\n5. **Evidence line in review table:** Each draft row includes \"Read: {N}\u002F{total} comments\" column\r\n\r\n### 4. Present\r\n\r\nShow drafts for review in this exact format:\r\n\r\n```text\r\n📝 PAO — Community Response Drafts\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n| # | Item | Author | Type | Confidence | Read | Preview |\r\n|---|------|--------|------|------------|------|---------|\r\n| 1 | Issue #N | @user | Type | 🟢\u002F🟡\u002F🔴 | N\u002FN | \"First words...\" |\r\n\r\nConfidence: 🟢 High | 🟡 Medium | 🔴 Needs review\r\n\r\nFull drafts below ▼\r\n```\r\n\r\nEach full draft must begin with the thread summary line:\r\n`Thread: {N} comments, last activity {date}, {summary of key points}`\r\n\r\n### 5. Human Action\r\n\r\nWait for explicit human direction before anything is posted.\r\n\r\n- `pao approve 1 3` — approve drafts 1 and 3\r\n- `pao edit 2` — edit draft 2\r\n- `pao skip` — skip all\r\n- `banana` — freeze all pending (safe word)\r\n\r\n### Rollback — Bad Post Recovery\r\n\r\nIf a posted response turns out to be wrong, inappropriate, or needs correction:\r\n\r\n1. **Delete the comment:**\r\n   - Issues: `gh api -X DELETE \u002Frepos\u002F{owner}\u002F{repo}\u002Fissues\u002Fcomments\u002F{comment_id}`\r\n   - Discussions: `gh api graphql -f query='mutation { deleteDiscussionComment(input: {id: \"{node_id}\"}) { comment { id } } }'`\r\n2. **Log the deletion:** Write audit entry with action `delete`, include reason and original content\r\n3. **Draft replacement** (if needed): PAO drafts a corrected response, goes through normal review cycle\r\n4. **Postmortem:** If the error reveals a pattern gap, update humanizer anti-patterns or add a new test case\r\n\r\n**Safe word — `banana`:**\r\n- Immediately freezes all pending drafts in the review queue\r\n- No new scans or drafts until `pao resume` is issued\r\n- Audit entry logged with halter identity and reason\r\n\r\n### 6. Post\r\n\r\nAfter approval:\r\n\r\n- Human posts via `gh issue comment` for issues or `gh api` for discussion answers\u002Fcomments.\r\n- PAO helps by preparing the CLI command.\r\n- Write the audit entry after the posting action.\r\n\r\n### 7. Audit\r\n\r\nLog every action.\r\n\r\n- Location: `.squad\u002Fcomms\u002Faudit\u002F{timestamp}.md`\r\n- Required fields vary by action — see `.squad\u002Fcomms\u002Ftemplates\u002Faudit-entry.md` Conditional Fields table\r\n- Universal required fields: `timestamp`, `action`\r\n- All other fields are conditional on the action type\r\n\r\n## Examples\r\n\r\nThese are reusable templates. Keep the structure, replace placeholders, and adjust only where the thread requires it.\r\n\r\n### Example scan command\r\n\r\n```bash\r\ngh issue list --state open --json number,title,author,labels,comments --limit 20\r\n```\r\n\r\n### Example review table\r\n\r\n```text\r\n📝 PAO — Community Response Drafts\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n| # | Item | Author | Type | Confidence | Read | Preview |\r\n|---|------|--------|------|------------|------|---------|\r\n| 1 | Issue #426 | @newdev | Welcome | 🟢 | 1\u002F1 | \"Hey @newdev! Welcome to Squad...\" |\r\n| 2 | Discussion #18 | @builder | Feature guidance | 🟡 | 4\u002F4 | \"Great question! Today the CLI...\" |\r\n| 3 | Issue #431 ⚠️ | @debugger | Technical uncertainty | 🔴 | 12\u002F12 | \"Interesting find, @debugger...\" |\r\n\r\nConfidence: 🟢 High | 🟡 Medium | 🔴 Needs review\r\n\r\nFull drafts below ▼\r\n```\r\n\r\n### Example audit entry (post action)\r\n\r\n```markdown\r\n---\r\ntimestamp: \"2026-03-16T21:30:00Z\"\r\naction: \"post\"\r\nitem_number: 426\r\ndraft_id: 1\r\nreviewer: \"@bradygaster\"\r\n---\r\n\r\n## Context (draft, approve, edit, skip, post, delete actions)\r\n- Thread depth: 3\r\n- Response type: welcome\r\n- Confidence: 🟢\r\n- Long thread flag: false\r\n\r\n## Draft Content (draft, edit, post actions)\r\nThread: 3 comments, last activity 2026-03-16, reporter hit a preview-build regression after install.\r\n\r\nHey @newdev! Welcome to Squad 👋 Thanks for opening this.\r\nWe reproduced the issue in preview builds and we're checking the regression point now.\r\nLet us know if you can share the command you ran right before the failure.\r\n\r\n## Post Result (post, delete actions)\r\nhttps:\u002F\u002Fgithub.com\u002Fbradygaster\u002Fsquad\u002Fissues\u002F426#issuecomment-123456\r\n```\r\n\r\n### T1 — Welcome\r\n\r\n```text\r\nHey {author}! Welcome to Squad 👋 Thanks for opening this.\r\n{specific acknowledgment or first answer}\r\nLet us know if you have questions — happy to help!\r\n```\r\n\r\n### T2 — Troubleshooting\r\n\r\n```text\r\nThanks for the detailed report, {author}!\r\nHere's what we think is happening: {explanation}\r\n{steps or workaround}\r\nLet us know if that helps, or if you're seeing something different.\r\n```\r\n\r\n### T3 — Feature Guidance\r\n\r\n```text\r\nGreat question! {context on current state}\r\n{guidance or workaround}\r\nWe've noted this as a potential improvement — {tracking info if applicable}.\r\n```\r\n\r\n### T4 — Redirect\r\n\r\n```text\r\nThanks for reaching out! This one is actually better suited for {correct location}.\r\n{brief explanation of why}\r\nFeel free to open it there — they'll be able to help!\r\n```\r\n\r\n### T5 — Acknowledgment\r\n\r\n```text\r\nGood catch, {author}. We've confirmed this is a real issue.\r\n{what we know so far}\r\nWe'll update this thread when we have a fix. Thanks for flagging it!\r\n```\r\n\r\n### T6 — Closing\r\n\r\n```text\r\nThis should be resolved in {version\u002FPR}! 🎉\r\n{brief summary of what changed}\r\nThanks for reporting this, {author} — it made Squad better.\r\n```\r\n\r\n### T7 — Technical Uncertainty\r\n\r\n```text\r\nInteresting find, {author}. We're not 100% sure what's causing this yet.\r\nHere's what we've ruled out: {list}\r\nWe'd love more context if you have it — {specific ask}.\r\nWe'll dig deeper and update this thread.\r\n```\r\n\r\n### T8 — Empathetic Disagreement\r\n\r\n```text\r\nWe hear you, {author}. That's a fair concern.\r\n\r\nThe current design choice was driven by {reason}. We know it's not ideal for every use case.\r\n\r\n{what alternatives exist or what trade-off was made}\r\n\r\nIf you have ideas for how to make this work better for your scenario, we'd love to hear them — open a discussion or drop your thoughts here!\r\n```\r\n\r\n### T9 — Information Request\r\n\r\n```text\r\nThanks for reporting this, {author}!\r\n\r\nTo help us dig into this, could you share:\r\n- {specific ask 1}\r\n- {specific ask 2}\r\n- {specific ask 3, if applicable}\r\n\r\nThat context will help us narrow down what's happening. Appreciate it!\r\n```\r\n\r\n## Anti-Patterns\r\n\r\n- ❌ Posting without human review (NEVER — this is the cardinal rule)\r\n- ❌ Drafting without reading full thread (context is everything)\r\n- ❌ Ignoring confidence flags (🔴 items need Flight\u002Fhuman review)\r\n- ❌ Scanning closed issues (only open items)\r\n- ❌ Responding to issues labeled `squad:internal` or `wontfix`\r\n- ❌ Skipping audit logging (every action must be recorded)\r\n- ❌ Drafting for issues where a squad member already responded (avoid duplicates)\r\n- ❌ Drafting pull request responses in Phase 1 (issues\u002Fdiscussions only)\r\n- ❌ Treating templates like loose examples instead of reusable drafting assets\r\n- ❌ Asking for more info without specific requests\r\n",{"name":5,"tools":48,"domain":65,"source":66,"confidence":67,"description":7},[49,53,57,61],{"name":50,"when":51,"description":52},"github-mcp-server-list_issues","Use for recent open issue scans before thread-level review","List open issues for scan candidates and lightweight triage",{"name":54,"when":55,"description":56},"github-mcp-server-issue_read","Use after selecting a candidate so PAO has complete thread context","Read the full issue, comments, and labels before drafting",{"name":58,"when":59,"description":60},"github-mcp-server-search_issues","Use when filtering by keywords, labels, or duplicate response checks","Search for candidate issues or prior squad responses",{"name":62,"when":63,"description":64},"gh CLI","Use gh issue list\u002Fcomment and gh api or gh api graphql when MCP coverage is incomplete","Fallback for GitHub issue comments and discussions workflows","community, communication, workflow","manual (RFC #426 — PAO External Communications)","low","dev","4ffda80d1bb1043d9169688cf161e53097345c72",".squad\u002Fskills\u002Fexternal-comms",0,"https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad","https:\u002F\u002Fgithub.com\u002FDeDuva","2026-11-09 20:24:44",{"source":8,"skillName":5,"commands":76,"prompt":86,"zipAvailable":87},[77,80,83],{"tool":78,"command":79},"npx","npx skills add DeDuva\u002Fsquad --skill external-comms",{"tool":81,"command":82},"bunx","bunx skills add DeDuva\u002Fsquad --skill external-comms",{"tool":84,"command":85},"pnpm","pnpm dlx skills add DeDuva\u002Fsquad --skill external-comms","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002F.squad\u002Fskills\u002Fexternal-comms\u002FSKILL.md",true,[],[90,102,110,127,149,164],{"skillNo":91,"name":92,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":96,"publishedAt":43},"01M719NE6ZPZT80MKVWFDECJZ3","My Skill","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftest-fixtures\u002Fskills-test-abb30454\u002Fmy-skill\u002FSKILL.md",[95],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[97,98,99,100,101],"my","my skill","testing","vitest","tester",{"skillNo":103,"name":104,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":43},"01M719NDJAMEWM8D9H355SCNA8","bad-skill","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftest-fixtures\u002Fskills-test-abb30454\u002Fbad-skill\u002FSKILL.md",[],[108,109],"bad skill","bad",{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":43},"01M719NCC1AZ02GHZ1V71YPEV7","squad-conventions","Core conventions and patterns used in the Squad codebase","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fsquad-conventions\u002FSKILL.md",[],[117,118,119,120,121,122,123,124,125,126],"conventions","squad","squad conventions","project-conventions","core","project","manual","high","codebase","patterns",{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":133,"publishedAt":43},"01M719NAYM17B7X8MGP681EHKQ","rework-rate","Measure and interpret PR rework rate — the emerging 5th DORA metric","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Frework-rate\u002FSKILL.md",[],[134,135,136,137,124,138,139,140,118,141,142,143,144,123,145,34,146,147,148,28],"rate","rework rate","health","analyze","review efficiency","quality","metric","metrics","efficiency","code quality","pr","prs","code","team","code-review",{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":155,"publishedAt":43},"01M719NA136PDC3SQ10R4R88TH","nap","Context hygiene — compress, prune, archive .squad\u002F state","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fnap\u002FSKILL.md",[],[151,156,157,158,159,160,161,162,118,163],"prune","state","maintenance","context hygiene","archive","hygiene","compress","context",{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":174,"publishedAt":43},"01M719N7B4PBQPNXW78TEJY4HQ","e2e-template-testing","End-to-end validation of coordinator and agent template changes","https:\u002F\u002Fgithub.com\u002FDeDuva\u002Fsquad\u002Fblob\u002Fdev\u002Ftemplates\u002Fskills\u002Fe2e-template-testing\u002FSKILL.md",[170,173],{"categoryNo":171,"categoryName":172,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},[99,175,176,177,178,179,180,123,181,124,182],"e2e template testing","e2e","template","end","coordinator","development","changes","validation"]