[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CWHPYTME5J93KEWXYERY4S":3,"skill-same:01M6CWHPYTME5J93KEWXYERY4S":98},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":35,"repositoryHtmlUrl":36,"repositoryHomepageUrl":37,"ownerHtmlUrl":38,"ownerBlogUrl":6,"ownerDescription":39,"updatedAt":40,"install":41,"resources":53},"01M6CWHPYTME5J93KEWXYERY4S","spec-promote",null,"Draft launch or promotion copy for a shipped feature.","leo-kuang-ai\u002Fspec-first","leo-kuang-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8476392?v=4","01M6CWDM2YRT5M8C3G3QC3YGR5","leokuang","01M6CWDM6X46EFBXT1M1GDB5XC",111,"MIT","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002FSKILL.md",[],[19,20,21,22,23,24],"spec","promote","spec promote","launch","linkedin","draft","2026-11-10 10:12:30",false,"---\nname: spec-promote\ndescription: \"Draft launch or promotion copy for a shipped feature.\"\ndisable-model-invocation: true\nargument-hint: \"[optional: what shipped and\u002For channels, e.g. 'a tweet thread and a LinkedIn post']\"\n---\n\n# spec-promote\n\nTurn a feature that just shipped into copy-pasteable, user-facing announcement copy — right inside the engineering workflow.\n\n## Purpose\n\nAfter you ship, the messaging shouldn't wait for a separate marketing pass. `spec-promote` figures out what shipped, picks the right channels, and drafts the copy. It is **spiral-agnostic by default**: with nothing installed it draws on a lite layer of editorial and social-media expertise to produce strong channel-specific copy. When the Spiral CLI (see `references\u002Fspiral-cli.md`) is present and authed, it uses Spiral so the drafts are voice-matched to your brand — a subtle enhancement, never a requirement.\n\n**The promotion output is draft-only. It never posts, publishes, commits, or opens PRs.** Posting is a human action. The only durable local preference exception is the separately disclosed and authorized Spiral opt-out write described in Path 0; it is not promotion output and must remain local-only.\n\n## Usage\n\n```bash\nspec-promote                                   # Derive what shipped from context, draft defaults\nspec-promote [free-form description]           # You describe what shipped\nspec-promote a tweet thread and a LinkedIn post   # Request specific channels\nspec-promote 3 tweet options for the new export feature\n```\n\n## Phase 1 — Figure out what shipped\n\nIf the user gave a free-form description of the feature, use it as the source of truth.\n\nOtherwise, derive it from context (use what's available; don't block on any one source):\n\n- **Merged\u002Factive PR** — `gh pr view --json title,body,url 2>\u002Fdev\u002Fnull` (and `gh pr view` for the current branch). The title and body usually state the user-facing value.\n- **The diff** — `git diff main...HEAD --stat` and skim notable changes to ground the claim in what actually changed.\n- **Changelog** — the top\u002F`[Unreleased]` entry in `docs\u002Fchangelog.md`, `CHANGELOG.md`, or similar.\n- **Recent commits** — `git log --oneline -15` for the arc of the change.\n\nThen write a 1–3 sentence summary of the **user-facing value** — what a user can now do that they couldn't before, and why they'd care. Describe the outcome, not the implementation. (\"You can now export any report to CSV in one click\" — not \"Added a CsvSerializer and an export endpoint.\")\n\nIf you can't confidently tell what shipped, ask the user one short question rather than guessing.\n\n## Phase 2 — Pick channels\n\nDefault to a small, sensible set:\n\n- **An X post or short thread** (lead with the value; thread only if the change warrants it)\n- **A one-line changelog \u002F release blurb**\n\nScale to what the change warrants and to what the user asked for. If they named channels (\"LinkedIn\", \"email\", \"a blog intro\", \"a short demo script\"), draft those instead of or in addition to the defaults. A small fix needs one or two short drafts; a flagship feature can justify a cross-channel set. Don't force a fixed template.\n\n## Phase 3 — Draft the copy\n\nFirst, detect Spiral's state with the Skill-owned bounded probe. Resolve `SKILL_DIR` from the `spec-promote\u002FSKILL.md` you loaded; do not run `spiral auth status` directly because provider stdout\u002Fstderr may contain secret-like fields:\n\n```bash\nSKILL_DIR=\"\u003Cabsolute path of the directory containing this SKILL.md>\"\nnode \"$SKILL_DIR\u002Fscripts\u002Fcheck-spiral-auth.cjs\"\n```\n\nClassify into one of three states:\n\n- **Unavailable** — `status: unavailable` → **Path 0** (install), then Path A if set up, else **Path B**.\n- **Ready** — `status: ready` and `authenticated: true` → **Path A** (voice-matched).\n- **Not ready \u002F unverified** — every other allowlisted status → **Path 0** when interactive, else **Path B**. Treat non-JSON, timeout, non-zero, and malformed provider output as unverified without inspecting or surfacing the raw bytes.\n\nNever let a Spiral failure, timeout, or odd output block or slow the skill — when in doubt, treat it as not-ready and continue.\n\n### Path 0 — Offer Spiral setup (first run, declinable)\n\nWhen Spiral isn't ready, offer to set it up **once** — unless the user previously opted out. The point is one proactive nudge, never a recurring one, and never a blocker: a decline always proceeds to Path B. **Any dismissal records the opt-out**, so a single first-run decline stops the offer for good in this repo — the user is never asked twice.\n\nRead `references\u002Fspiral-cli.md` for the exact setup prompt (built with the platform's blocking-question tool), the connect\u002Finstall steps, and how the opt-out is recorded so later runs skip this. In short:\n\n- **Unauthed** → the agent runs `spiral login --json` (CLI >= 1.8.0; non-blocking, the API key never passes through the agent). On `status: already_authenticated` → use Path A. On `status: pending` → surface the `auth_url`, the user approves in their browser, then re-run the bounded auth probe after the user's confirmation; `status: ready` → Path A. Never have the user paste a key into chat. (Older CLI without agent login → suggest `npm i -g @every-env\u002Fspiral-cli@latest`, or have the user run `spiral login` themselves.) Escape hatch: \"or the agent can just draft directly, without Spiral's personalization and humanization.\"\n- **Absent** → guide the user to install + connect in one step via the pairing-code command from Settings → Connect an Agent.\n- **Decline** → record the opt-out (best-effort) and go to Path B.\n\nSkip Path 0 entirely — straight to Path B — when the opt-out is already recorded, or when running headless \u002F non-interactive (no human to answer). If a human is present but no blocking-question tool is available, do **not** skip — fall back to a numbered list of the two options in chat and wait for a reply (per the Ask section of `references\u002Fspiral-cli.md`).\n\n### Path A — Spiral ready (voice-matched)\n\nUse the Spiral CLI so drafts match the user's brand voice. **Read `references\u002Fspiral-cli.md` before composing the prompt** — multi-channel vs. single-channel-variations is phrasing-driven (channel keywords \u002F cue words vs. `--num-drafts`) and getting it wrong silently returns the wrong number or shape of drafts. The exact phrasing rules live there; don't restate them from memory. Essentials:\n\nBefore sending feature context or promotion copy to Spiral, record `provider_egress_authorization: authorized | missing`. Authentication, installation, prior use, requested channels, and general drafting intent do not authorize a run-local content transfer. Display the provider, content categories being sent, persistence behavior, and local Path B alternative; proceed only when the current request or a new confirmation explicitly authorizes this transfer. Missing authority returns `provider_egress_authorization_missing` and uses Path B with zero `spiral write` calls.\n\n- Always pass `--instant` and `--json`. Parse `drafts[]` (each carries its own `channel`) plus `session_id`.\n- **Present every returned draft, grouped by `channel`.** Spiral decides how many drafts per channel — multi-channel runs often return several per channel — so never assume one-per-channel or drop extras.\n\nIf the authorized `spiral write` call errors or returns no usable drafts, fall back to Path B for the affected channels, but do not describe the run as local-only. Return a safe provider receipt with `provider_attempt: attempted`, `delivery_status: unknown`, an allowlisted `reason_code`, `persistence_status: possible-or-unknown`, and `fallback_used: true`. Never copy raw Spiral stdout\u002Fstderr, exception text, internal commentary, or secret-like fields into chat, logs, or durable artifacts.\n\n### Path B — Direct drafting (lite editorial & social expertise)\n\nNo Spiral needed — draft strong copy directly using a compact layer of editorial and social-media fundamentals. (The Spiral path goes further: brand-voice matching, humanization, saved styles, and cross-channel campaign orchestration.)\n\n**Editorial fundamentals** — every channel:\n- Lead with the user-facing outcome: what someone can now do, not how it was built.\n- One idea per piece. Cut windup, hedges, and throat-clearing.\n- Be concrete and specific; show the value, don't assert it.\n- Plain, active language. Strip AI tells — \"thrilled\u002Fexcited to announce,\" \"game-changer,\" \"in today's fast-paced world,\" \"unlock\u002Fleverage\u002Fseamless,\" em-dash padding.\n- Sanity check: read it as if saying it to one user. If a person wouldn't say it, rewrite it.\n\n**Social fundamentals** — distributed channels:\n- The first line is the hook and has to earn the next line (feeds truncate). No preamble.\n- Match each channel's native shape and length; never reuse one draft verbatim across channels.\n- One clear CTA where the channel supports it.\n- Hashtags: 0–2, only where the channel expects them — never a wall of tags.\n\n**Per channel:**\n- **X** — value in the first line; ~1–3 tight lines. Thread only when there's more than one beat worth its own line.\n- **Changelog \u002F release blurb** — one declarative line naming the new capability. Plain, not promotional.\n- **LinkedIn** — a short paragraph: human angle (why it matters), then the what. Warmer than X.\n- **Email** — benefit-stating subject + 2–4 sentence body + one CTA.\n- **Blog intro** — one strong opening paragraph framing the problem and the new capability; leave the deep-dive to the author.\n- **Demo script** — 3–6 spoken beats: hook, problem, action, payoff.\n\n**Drafts per channel:** one strong draft by default; produce more only when asked (\"3 tweet options\"), capped ~3.\n\n## Phase 4 — Present the drafts\n\nShow every draft as a clean, copy-pasteable block, labeled by channel. For each:\n\n```\n### X post\n\u003Cthe copy>\n```\n\n- If Spiral produced them, also surface the `session_id` and each draft's `url` so the user can open and tweak them in the Spiral web app.\n- Offer to revise (tone, length, angle, more variations, another channel).\n- **Do not post, publish, schedule, commit, or open a PR.** End by reminding the user the drafts are theirs to ship.\n- If Path 0 recorded the local preference exception, disclose that local-only write once and keep it separate from the draft-output claim.\n\n## Examples\n\n**Single-channel variations — \"3 tweet options\":**\n> User: `spec-promote 3 tweet options for the new one-click CSV export`\n> → Summarize the value. Spiral path: `spiral write \"3 tweet options for one-click CSV export\" --instant --num-drafts 3 --json` (no cue words). No-Spiral path: write 3 distinct tweets directly. Present all three.\n\n**Multi-channel set — \"a campaign across X, LinkedIn, and email\":**\n> User: `spec-promote draft a launch across X, LinkedIn, and email`\n> → Spiral path: `spiral write \"announcing one-click CSV export — a launch across X, LinkedIn, and email\" --instant --json` returns a set of drafts per channel (Spiral decides the count — often several), each carrying its `channel`. (`--num-drafts` ignored here.) No-Spiral path: draft one X post, one LinkedIn post, one email directly. Present every returned draft, grouped by channel.\n","# spec-promote\n\nTurn a feature that just shipped into copy-pasteable, user-facing announcement copy — right inside the engineering workflow.\n\n## Purpose\n\nAfter you ship, the messaging shouldn't wait for a separate marketing pass. `spec-promote` figures out what shipped, picks the right channels, and drafts the copy. It is **spiral-agnostic by default**: with nothing installed it draws on a lite layer of editorial and social-media expertise to produce strong channel-specific copy. When the Spiral CLI (see `references\u002Fspiral-cli.md`) is present and authed, it uses Spiral so the drafts are voice-matched to your brand — a subtle enhancement, never a requirement.\n\n**The promotion output is draft-only. It never posts, publishes, commits, or opens PRs.** Posting is a human action. The only durable local preference exception is the separately disclosed and authorized Spiral opt-out write described in Path 0; it is not promotion output and must remain local-only.\n\n## Usage\n\n```bash\nspec-promote                                   # Derive what shipped from context, draft defaults\nspec-promote [free-form description]           # You describe what shipped\nspec-promote a tweet thread and a LinkedIn post   # Request specific channels\nspec-promote 3 tweet options for the new export feature\n```\n\n## Phase 1 — Figure out what shipped\n\nIf the user gave a free-form description of the feature, use it as the source of truth.\n\nOtherwise, derive it from context (use what's available; don't block on any one source):\n\n- **Merged\u002Factive PR** — `gh pr view --json title,body,url 2>\u002Fdev\u002Fnull` (and `gh pr view` for the current branch). The title and body usually state the user-facing value.\n- **The diff** — `git diff main...HEAD --stat` and skim notable changes to ground the claim in what actually changed.\n- **Changelog** — the top\u002F`[Unreleased]` entry in `docs\u002Fchangelog.md`, `CHANGELOG.md`, or similar.\n- **Recent commits** — `git log --oneline -15` for the arc of the change.\n\nThen write a 1–3 sentence summary of the **user-facing value** — what a user can now do that they couldn't before, and why they'd care. Describe the outcome, not the implementation. (\"You can now export any report to CSV in one click\" — not \"Added a CsvSerializer and an export endpoint.\")\n\nIf you can't confidently tell what shipped, ask the user one short question rather than guessing.\n\n## Phase 2 — Pick channels\n\nDefault to a small, sensible set:\n\n- **An X post or short thread** (lead with the value; thread only if the change warrants it)\n- **A one-line changelog \u002F release blurb**\n\nScale to what the change warrants and to what the user asked for. If they named channels (\"LinkedIn\", \"email\", \"a blog intro\", \"a short demo script\"), draft those instead of or in addition to the defaults. A small fix needs one or two short drafts; a flagship feature can justify a cross-channel set. Don't force a fixed template.\n\n## Phase 3 — Draft the copy\n\nFirst, detect Spiral's state with the Skill-owned bounded probe. Resolve `SKILL_DIR` from the `spec-promote\u002FSKILL.md` you loaded; do not run `spiral auth status` directly because provider stdout\u002Fstderr may contain secret-like fields:\n\n```bash\nSKILL_DIR=\"\u003Cabsolute path of the directory containing this SKILL.md>\"\nnode \"$SKILL_DIR\u002Fscripts\u002Fcheck-spiral-auth.cjs\"\n```\n\nClassify into one of three states:\n\n- **Unavailable** — `status: unavailable` → **Path 0** (install), then Path A if set up, else **Path B**.\n- **Ready** — `status: ready` and `authenticated: true` → **Path A** (voice-matched).\n- **Not ready \u002F unverified** — every other allowlisted status → **Path 0** when interactive, else **Path B**. Treat non-JSON, timeout, non-zero, and malformed provider output as unverified without inspecting or surfacing the raw bytes.\n\nNever let a Spiral failure, timeout, or odd output block or slow the skill — when in doubt, treat it as not-ready and continue.\n\n### Path 0 — Offer Spiral setup (first run, declinable)\n\nWhen Spiral isn't ready, offer to set it up **once** — unless the user previously opted out. The point is one proactive nudge, never a recurring one, and never a blocker: a decline always proceeds to Path B. **Any dismissal records the opt-out**, so a single first-run decline stops the offer for good in this repo — the user is never asked twice.\n\nRead `references\u002Fspiral-cli.md` for the exact setup prompt (built with the platform's blocking-question tool), the connect\u002Finstall steps, and how the opt-out is recorded so later runs skip this. In short:\n\n- **Unauthed** → the agent runs `spiral login --json` (CLI >= 1.8.0; non-blocking, the API key never passes through the agent). On `status: already_authenticated` → use Path A. On `status: pending` → surface the `auth_url`, the user approves in their browser, then re-run the bounded auth probe after the user's confirmation; `status: ready` → Path A. Never have the user paste a key into chat. (Older CLI without agent login → suggest `npm i -g @every-env\u002Fspiral-cli@latest`, or have the user run `spiral login` themselves.) Escape hatch: \"or the agent can just draft directly, without Spiral's personalization and humanization.\"\n- **Absent** → guide the user to install + connect in one step via the pairing-code command from Settings → Connect an Agent.\n- **Decline** → record the opt-out (best-effort) and go to Path B.\n\nSkip Path 0 entirely — straight to Path B — when the opt-out is already recorded, or when running headless \u002F non-interactive (no human to answer). If a human is present but no blocking-question tool is available, do **not** skip — fall back to a numbered list of the two options in chat and wait for a reply (per the Ask section of `references\u002Fspiral-cli.md`).\n\n### Path A — Spiral ready (voice-matched)\n\nUse the Spiral CLI so drafts match the user's brand voice. **Read `references\u002Fspiral-cli.md` before composing the prompt** — multi-channel vs. single-channel-variations is phrasing-driven (channel keywords \u002F cue words vs. `--num-drafts`) and getting it wrong silently returns the wrong number or shape of drafts. The exact phrasing rules live there; don't restate them from memory. Essentials:\n\nBefore sending feature context or promotion copy to Spiral, record `provider_egress_authorization: authorized | missing`. Authentication, installation, prior use, requested channels, and general drafting intent do not authorize a run-local content transfer. Display the provider, content categories being sent, persistence behavior, and local Path B alternative; proceed only when the current request or a new confirmation explicitly authorizes this transfer. Missing authority returns `provider_egress_authorization_missing` and uses Path B with zero `spiral write` calls.\n\n- Always pass `--instant` and `--json`. Parse `drafts[]` (each carries its own `channel`) plus `session_id`.\n- **Present every returned draft, grouped by `channel`.** Spiral decides how many drafts per channel — multi-channel runs often return several per channel — so never assume one-per-channel or drop extras.\n\nIf the authorized `spiral write` call errors or returns no usable drafts, fall back to Path B for the affected channels, but do not describe the run as local-only. Return a safe provider receipt with `provider_attempt: attempted`, `delivery_status: unknown`, an allowlisted `reason_code`, `persistence_status: possible-or-unknown`, and `fallback_used: true`. Never copy raw Spiral stdout\u002Fstderr, exception text, internal commentary, or secret-like fields into chat, logs, or durable artifacts.\n\n### Path B — Direct drafting (lite editorial & social expertise)\n\nNo Spiral needed — draft strong copy directly using a compact layer of editorial and social-media fundamentals. (The Spiral path goes further: brand-voice matching, humanization, saved styles, and cross-channel campaign orchestration.)\n\n**Editorial fundamentals** — every channel:\n- Lead with the user-facing outcome: what someone can now do, not how it was built.\n- One idea per piece. Cut windup, hedges, and throat-clearing.\n- Be concrete and specific; show the value, don't assert it.\n- Plain, active language. Strip AI tells — \"thrilled\u002Fexcited to announce,\" \"game-changer,\" \"in today's fast-paced world,\" \"unlock\u002Fleverage\u002Fseamless,\" em-dash padding.\n- Sanity check: read it as if saying it to one user. If a person wouldn't say it, rewrite it.\n\n**Social fundamentals** — distributed channels:\n- The first line is the hook and has to earn the next line (feeds truncate). No preamble.\n- Match each channel's native shape and length; never reuse one draft verbatim across channels.\n- One clear CTA where the channel supports it.\n- Hashtags: 0–2, only where the channel expects them — never a wall of tags.\n\n**Per channel:**\n- **X** — value in the first line; ~1–3 tight lines. Thread only when there's more than one beat worth its own line.\n- **Changelog \u002F release blurb** — one declarative line naming the new capability. Plain, not promotional.\n- **LinkedIn** — a short paragraph: human angle (why it matters), then the what. Warmer than X.\n- **Email** — benefit-stating subject + 2–4 sentence body + one CTA.\n- **Blog intro** — one strong opening paragraph framing the problem and the new capability; leave the deep-dive to the author.\n- **Demo script** — 3–6 spoken beats: hook, problem, action, payoff.\n\n**Drafts per channel:** one strong draft by default; produce more only when asked (\"3 tweet options\"), capped ~3.\n\n## Phase 4 — Present the drafts\n\nShow every draft as a clean, copy-pasteable block, labeled by channel. For each:\n\n```\n### X post\n\u003Cthe copy>\n```\n\n- If Spiral produced them, also surface the `session_id` and each draft's `url` so the user can open and tweak them in the Spiral web app.\n- Offer to revise (tone, length, angle, more variations, another channel).\n- **Do not post, publish, schedule, commit, or open a PR.** End by reminding the user the drafts are theirs to ship.\n- If Path 0 recorded the local preference exception, disclose that local-only write once and keep it separate from the draft-output claim.\n\n## Examples\n\n**Single-channel variations — \"3 tweet options\":**\n> User: `spec-promote 3 tweet options for the new one-click CSV export`\n> → Summarize the value. Spiral path: `spiral write \"3 tweet options for one-click CSV export\" --instant --num-drafts 3 --json` (no cue words). No-Spiral path: write 3 distinct tweets directly. Present all three.\n\n**Multi-channel set — \"a campaign across X, LinkedIn, and email\":**\n> User: `spec-promote draft a launch across X, LinkedIn, and email`\n> → Spiral path: `spiral write \"announcing one-click CSV export — a launch across X, LinkedIn, and email\" --instant --json` returns a set of drafts per channel (Spiral decides the count — often several), each carrying its `channel`. (`--num-drafts` ignored here.) No-Spiral path: draft one X post, one LinkedIn post, one email directly. Present every returned draft, grouped by channel.\n",{"name":5,"description":7,"argument-hint":30,"disable-model-invocation":31},"[optional: what shipped and\u002For channels, e.g. 'a tweet thread and a LinkedIn post']",true,"master","74655dc86b1270bb52239e0f8bc9517de7a7071c","skills\u002Fspec-promote",13,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first","http:\u002F\u002Fspec-first.cn\u002F","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai","作为一个初学者或者进阶者，这并没有什么错。当一个有能力的程序员而不是领导者，这也没有什么错。真正的错误是，当你知道应该如何去提高时仍然选择做一名初学者。","2026-11-05 13:30:55",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":31},[43,46,49],{"tool":44,"command":45},"npx","npx skills add leo-kuang-ai\u002Fspec-first --skill spec-promote",{"tool":47,"command":48},"bunx","bunx skills add leo-kuang-ai\u002Fspec-first --skill spec-promote",{"tool":50,"command":51},"pnpm","pnpm dlx skills add leo-kuang-ai\u002Fspec-first --skill spec-promote","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002FSKILL.md",[54,60,64,68,72,76,82,86,90,94],{"path":55,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":59},"evals\u002Fcases\u002Fno-publish-side-effects.yaml","REFERENCE","参考文档",1007,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Fcases\u002Fno-publish-side-effects.yaml",{"path":61,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":62,"sourceHtmlUrl":63},"evals\u002Fcases\u002Fnothing-shipped-asks.yaml",731,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Fcases\u002Fnothing-shipped-asks.yaml",{"path":65,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":66,"sourceHtmlUrl":67},"evals\u002Feval.yaml",353,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Feval.yaml",{"path":69,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":70,"sourceHtmlUrl":71},"evals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002Fpackage.json",96,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002Fpackage.json",{"path":73,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":74,"sourceHtmlUrl":75},"evals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002FREADME.md",365,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002FREADME.md",{"path":77,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":80,"sourceHtmlUrl":81},"evals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002Fsrc\u002Fserver.js","SCRIPT","脚本",665,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Ffixtures\u002Frepos\u002Fmini-ledger\u002Fsrc\u002Fserver.js",{"path":83,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":84,"sourceHtmlUrl":85},"evals\u002Ffixtures\u002Fscripts\u002Fasks-a-question.sh",1265,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Ffixtures\u002Fscripts\u002Fasks-a-question.sh",{"path":87,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":88,"sourceHtmlUrl":89},"evals\u002Ffixtures\u002Fscripts\u002Fcheck-no-publish.sh",1521,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fevals\u002Ffixtures\u002Fscripts\u002Fcheck-no-publish.sh",{"path":91,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Fspiral-cli.md",12694,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Freferences\u002Fspiral-cli.md",{"path":95,"resourceType":78,"resourceTypeDesc":79,"sizeBytes":96,"sourceHtmlUrl":97},"scripts\u002Fcheck-spiral-auth.cjs",2017,"https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-promote\u002Fscripts\u002Fcheck-spiral-auth.cjs",[99,135,157,171,185,205],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":115,"publishedAt":25},"01M6CWKQCYJXDCW4MEF3FSJE26","using-spec-first","Standalone entry governor for spec-first. Use before substantial work in a spec-first repo or when the user asks what to run next; choose one public `spec-*` workflow, standalone skill, terminal command, or Direct Lane. Do not use to reroute active public workflows or bounded workers, or for lightweight facts, current-context explanations, narrow lookups, user-supplied single-document cleanup, or clearly scoped low-risk edits.","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fusing-spec-first\u002FSKILL.md",[105,110],{"categoryNo":106,"categoryName":107,"taxonomyType":108,"taxonomyTypeDesc":109},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",{"categoryNo":111,"categoryName":112,"taxonomyType":113,"taxonomyTypeDesc":114},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[19,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134],"first","using spec first","terminal","work","active","next","do","use","context","command","repo","choose","direct","risk","lane","run","cleanup","workflows","workflow",{"skillNo":136,"name":137,"nameZh":6,"description":138,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":139,"categories":140,"keywords":142,"publishedAt":25},"01M6CWKK43ZJKQXKVJB3BWWPR1","spec-write-tasks","Public workflow entrypoint (spec-write-tasks): compile a settled local spec-plan into an optional derived task pack for spec-work, or validate an existing local task pack before execution. Use for explicit plan-splitting\u002Ftask-doc requests or high-complexity work suitability; do not use for plan authoring, implementation execution, unresolved scope, small low-risk plans, progress\u002Fapproval state, remote\u002Fgeneric task lists, or generated runtime mirror edits. Keep the plan as single source of truth; tasks are derived and optional.","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-write-tasks\u002FSKILL.md",[141],{"categoryNo":106,"categoryName":107,"taxonomyType":108,"taxonomyTypeDesc":109},[19,143,144,145,146,147,122,148,149,123,150,119,151,152,129,153,154,155,134,156],"tasks","write","spec write tasks","local","task","complexity","plan authoring","generated","plan","doc","execution","compile","validate","state",{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":164,"publishedAt":25},"01M6CWKEK6CVPQW8EMCNSDPHBJ","spec-write-skill","公开 workflow：创建、修改或迁移项目拥有的 Agent Skill package，或对现有\u002F外部 package 做用户明确要求、零执行的只读验证与 readiness 报告时使用；也用于按已接受的 audit finding 修复 source skill。不要用于一次性回答、解释\u002F总结\u002F翻译、普通代码 review、第三方 Skill 纯安装或导入、跨仓批量修改，或直接修补 generated runtime mirrors。","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-write-skill\u002FSKILL.md",[163],{"categoryNo":106,"categoryName":107,"taxonomyType":108,"taxonomyTypeDesc":109},[165,19,144,166,167,150,168,169,134,170],"spec write skill","write skill","audit","翻译","package","review",{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":25},"01M6CWKBDEZ7QFF1ZH3DP52SHA","spec-worktree","Internal helper for caller-owned git worktree isolation. Governed callers are spec-dogfood and spec-work; every caller must provide the forward invocation and intake contract.","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-worktree\u002FSKILL.md",[],[19,178,179,180,181,182,183,119,184],"worktree","spec worktree","intake","git","Bash","dogfood","git worktree",{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":192,"publishedAt":25},"01M6CWK5W4VREMNXGQQKXXSQ3N","spec-work","Execute a settled plan, validated task pack, spec path, or concrete implementation request end-to-end. Use spec-debug for open-ended bugs; stop when target repo, scope, source ownership, or required authorization is unresolved. Not for explicitly requested GitHub PR-review-feedback handling — route those to spec-resolve-pr-feedback.","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-work\u002FSKILL.md",[191],{"categoryNo":111,"categoryName":112,"taxonomyType":113,"taxonomyTypeDesc":114},[119,193,19,194,195,196,197,198,147,199,200,201,123,126,202,203,151,204,152,170],"spec work","stop","github","to spec","debug","route","github pr","implementation","auto","pr","feedback","open",{"skillNo":206,"name":207,"nameZh":6,"description":208,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":209,"categories":210,"keywords":216,"publishedAt":25},"01M6CWK1MFTSNV9MYD4C8WGB8B","spec-test-xcode","Build and test iOS apps on simulator using XcodeBuildMCP. Use after making iOS code changes, before creating a PR, or when verifying app behavior and checking for crashes on simulator.","https:\u002F\u002Fgithub.com\u002Fleo-kuang-ai\u002Fspec-first\u002Fblob\u002Fmaster\u002Fskills\u002Fspec-test-xcode\u002FSKILL.md",[211,214,215],{"categoryNo":212,"categoryName":213,"taxonomyType":108,"taxonomyTypeDesc":109},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":106,"categoryName":107,"taxonomyType":108,"taxonomyTypeDesc":109},{"categoryNo":111,"categoryName":112,"taxonomyType":113,"taxonomyTypeDesc":114},[19,217,218,202,219,220,221,222,123,223,224],"test","spec test xcode","code","ios","build and test","behavior","default","build"]