跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

ln-64-community-announcer

Drafts and publishes fact-checked GitHub Discussions announcements. Use for releases, updates, or project news; not for release creation or issue responses.

levnikolaevich · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add levnikolaevich/claude-code-skills --skill ln-64-community-announcer

技能说明


name: ln-64-community-announcer description: "Drafts and publishes fact-checked GitHub Discussions announcements. Use for releases, updates, or project news; not for release creation or issue responses."

Community Announcer

Goal: Create a source-backed announcement and publish it only after the user approves the full draft.

Execution contract: Treat the ordered checkbox workflow below as this skill's Definition of Done. Track every checkbox as PENDING, then resolve it to PROVEN with concrete evidence, CLEARED with evidence that its conditional trigger is absent, or UNPROVEN; reading, mentioning, delegating, skipping, or tool failure is not proof. Before returning, resolve every PENDING, count only PROVEN and CLEARED items as complete, apply this skill's verdict, decision, and approval rules to every UNPROVEN, and prepend Checklist: X/Y completeIncomplete: None | section/item — reason; outcome impact; exact next action; list every UNPROVEN item.

Tool Routing

NeedPreferred capabilityFallback
Repository identity and permissionsAuthenticated GitHub CLI or connectorPublic GitHub API for read-only discovery
Discussion categories and publicationGitHub GraphQL APIBLOCKED; do not substitute an issue
Shipped-change evidenceRemote Git history, releases, and canonical filesClean remote clone
Commands, paths, names, and countsFocused repository search and direct readsHosting API content reads
Current external claimsPrimary dated sourcesOmit the claim when it cannot be verified
Draft publicationTemporary Markdown file passed to the APISafely escaped API input with read-back verification

Prefer the hosting API over scraping rendered pages. Use the browser only to inspect presentation or a page the API cannot expose.

Do not expose repository tokens, category node IDs, or other credentials in the announcement. IDs may be used for the mutation but are not audience content.

Checklist

  • Resolve the target repository from the authenticated hosting client and verify write access.
  • Discover the repository ID, default branch, Discussions availability, and a repository-approved suitable category through the API.
  • Stop with BLOCKED when Discussions or a suitable category is unavailable; do not silently publish elsewhere.
  • Identify the announcement subject from the user's request, a release, or a bounded commit range.
  • Read repository communication guidance when present, but do not require a community strategy file.
  • Read the current authoritative documentation, installation instructions, affected manifests, release notes, and relevant source diffs when present.
  • Inspect recent commits and up to three available comparable announcements for cadence, repeated claims, and house style; do not require prior announcements in a new or low-volume repository.
  • Use the target remote state as the source for already-published changes; do not announce an unpushed local diff as available.
  • Separate what shipped, what changed for users, migration needs, and future intent.

Classification and Style

  • Classify the announcement as release, breaking change, feature update, architecture change, or community news.
  • Choose the shortest style that explains the user outcome and its significance.
  • Use a concise release digest for several independent changes.
  • Use a problem-to-solution narrative when the motivation is necessary to understand the redesign.
  • Use migration-first structure when existing users must take action.
  • Vary the opening from recent announcements when doing so remains natural; variety is not more important than clarity.
  • Do not force emoji, slogans, dramatic metaphors, or a fixed template.
  • Match the project's voice while keeping claims understandable without internal repository context.

Draft

  • Write a specific title that names the outcome rather than saying only "update" or "announcement".
  • Open with the user problem or the most important shipped outcome.
  • Explain why the change was made using evidence from commits, docs, or release notes.
  • Summarize highlights in outcome language and name exact products, packages, plugins, skills, or components where useful.
  • Include verified installation or update commands when the reader must act.
  • Add an IMPORTANT migration block for breaking changes, including clear before-and-after steps.
  • Link to canonical documentation at the default branch or immutable release tag as appropriate.
  • Include a short "What's next" section only for committed or clearly labelled tentative work.
  • Thank verified external contributors by handle; omit the section for solo work.
  • End with one genuine, answerable feedback question when community input would be useful.

Fact Check

  • Verify every command against current authoritative documentation and any stable package, plugin, or marketplace identifier it uses.
  • Verify every named product, package, plugin, skill, component, file path, category, version, tag, and link against the remote repository.
  • Recompute every count from the target commit; avoid counts when they add no user value.
  • Confirm feature descriptions against the actual changed source, documentation, or manifest, not commit-title shorthand.
  • Confirm removed capabilities and compatibility limits are stated explicitly.
  • Do not invent adoption, download, search-volume, performance, compatibility, or roadmap claims.
  • Label estimates, interpretations, and future intent instead of presenting them as shipped facts.
  • Remove generic hype, repeated conclusions, excessive headings, canned transitions, and symmetrical filler lists.
  • Prefer concrete verbs and varied sentence length; keep technical identifiers only where readers need them.
  • Re-read the draft as a n
阅读完整来源 ↗