用途:把任务或实验想法整理成 microsoft/agent-academy 仓库上的 GitHub issue 规格,供他人据此实现,不产出任务正文。
主要能力:先抓取用户提供的文档 URL,提取工具/API 名称、参数、端点、许可与角色前提、治理与可观测面等;再批量询问任务状态、类型(Recruit/Operative/Commander/Special Ops/Cowork Collective)、场景、产品面、难度与时长、里程碑、交付方式;随后做仓库侦察,包括文档与 issue 双重查重、读取对应贡献指南、校验 tags/products/industries slug、找最接近的现有任务、阅读 WRITING_STYLE.md;最后按约定标题格式与正文结构起草,经写作风格检查后发布。
使用方式:需先运行 gh --version 确认 GitHub CLI 已安装(macOS 可用 brew install gh),再运行 gh auth status 确认认证,未认证则 gh auth login。列出里程碑用 GH_PAGER=cat gh api repos/microsoft/agent-academy/milestones --jq '.[] | "(.title) due=(.due_on)"';查重用 GH_PAGER=cat gh issue list --repo microsoft/agent-academy --state all --search "<keyword>";发布用 gh issue create --repo microsoft/agent-academy --title "<title>" --label feature-request --milestone "FY27Q1" --assignee "<login>" --body-file /tmp/<name>.md;回读用 GH_PAGER=cat gh issue view <number> --repo microsoft/agent-academy --json title,labels,milestone,assignees,url。
适用场景:为 agent-academy 各任务轨道提出新任务或更新既有任务的规格 issue。
限制:不创建 docs/ 下的任务 markdown;不编造 slug;发布前需用户确认;issue 必须带里程碑;gh 命令需加 GH_PAGER=cat;正文用 --body-file 传入;临时文件放 /tmp/ 并删除;gh issue view --json 不要请求 projectCards;规格中不得写 click 或 textbox。