SuperAPI AI 工具集

gsdl-fetch-source

办公与效率

查看项目

更新于 10-16 07:23

技能介绍

用途:gsdl-fetch-source 是 GSDL 流水线九个步骤中的第一步(Pick up source → Brainstorm → SPEC.md → Slices → Review → Branch → Execute → Verify → PR + bot → Close loop),把任意起点统一转成项目:创建 .planning/[project-name]/ 目录并生成 seed.md,输出项目名、seed 路径、工作项 ID、tracker 建议分支名与一句话来源摘要。

支持的起点与主要能力:三类起点在 Step 3 之后处理一致。工作项(Linear、Jira、GitHub Issues、Notion 中的 tracker 行)、规范文档(Notion、Slite、Confluence,若配置了 tracker 且用户需要父项则建子项)、以及朴素想法(无 tracker,tasks.md 即工作项列表)。自动识别来源类型,包含 Linear 的 ABC-123、Jira 的 KEY-123、GitHub 的 owner/repo#12 或 issue URL、notion.so/notion.site、slite.com、atlassian.net/wiki 等模式;裸 ID 先用配置的 tracker 消歧,SOURCE_TYPE 可覆盖。

使用方式:按 Step 1 解析配置(读取或探测 MCP、凭证环境变量、gh auth status 后写 .planning/gsdl.config.md);Step 2 分类来源;Step 3 依次尝试 Method 0 MCP、Method A API+凭证(Linear GraphQL、Jira REST、gh issue view、Notion API、Slite API、Confluence API)、Method B 公开网页抓取、Method C 手动粘贴、Method D 无来源的纯想法;Step 4 生成 kebab-case 项目名(有 ID 则加前缀,≤40 字符);Step 5-6 建目录并写 seed.md(含标题、Source、Initial Idea、Problem/Opportunity、Key Features / Acceptance Criteria、Questions/Uncertainties、Next Steps);Step 7 确认并交接给 gsdl-create-spec。

限制与注意:该步骤为 SMALL 等级,属机械操作,作为子代理运行时非交互式,遇到已有项目文件夹、手册回退或无法解析的输入应返回 BLOCKER 而非猜测或覆盖;若 .planning/[project-name]/ 已有 seed.md,需询问重新抓取覆盖还是保留;无描述的条目仍会建项目并注明;自动抓取仅适用于公开分享内容,抓取内容过短(<50 字符)会告警。

适用场景:需要把工作项、规格文档或想法快速转为 GSDL 项目种子的团队与个人。