Agent Skills
› open-gsd/gsd-pi
open-gsd/gsd-pi
GitHub通过编排GSD无头CLI自动构建软件。负责编写规范、启动构建、轮询状态、处理阻塞及验证结果，实现从需求到交付的全流程自动化开发。
Install All Skills
npx skills add open-gsd/gsd-pi --all -g -y
Skills in Collection (37)
通过编排GSD无头CLI自动构建软件。负责编写规范、启动构建、轮询状态、处理阻塞及验证结果，实现从需求到交付的全流程自动化开发。
用户要求从头构建项目或创建新工程
需要运行GSD进行自主软件开发
查询或监控构建任务的状态与进度
npx skills add open-gsd/gsd-pi --skill gsd-orchestrator -g -y
提供基于WCAG 2.1的Web无障碍审计与改进指南，涵盖图片替代文本、图标命名、颜色对比度等关键实践，确保内容对残障人士可用。
improve accessibility
a11y audit
WCAG compliance
screen reader support
keyboard navigation
make accessible
npx skills add open-gsd/gsd-pi --skill accessibility -g -y
基于agent-browser的浏览器自动化CLI工具，支持导航、截图、表单填写及数据抓取。适用于网页交互、Web应用测试及程序化网站操作场景。
打开网页
填写表单
截取屏幕快照
从页面抓取数据
测试Web应用
自动化浏览器操作
npx skills add open-gsd/gsd-pi --skill agent-browser -g -y
专注于HTTP/REST/GraphQL API设计与审查的Skill，涵盖版本控制、分页、错误处理及幂等性等核心规范，旨在构建长期稳定且语义清晰的接口。
设计API
审查API
添加新端点
定义Schema
npx skills add open-gsd/gsd-pi --skill api-design -g -y
提供现代Web开发最佳实践，涵盖安全、兼容性和代码质量。指导HTTPS强制、CSP配置、安全头设置、依赖审计及输入 sanitization，防止漏洞并提升应用安全性与规范性。
apply best practices
security audit
modernize code
code quality review
check for vulnerabilities
npx skills add open-gsd/gsd-pi --skill best-practices -g -y
用于在当前会话中快速回答基于已有上下文的辅助性问题，不调用工具或读取新文件，保持简短并迅速回归主任务。
用户通过 /btw 命令提出与当前工作相关的快速疑问
需要回顾已读文件或已知决策但不希望中断主要流程
npx skills add open-gsd/gsd-pi --skill btw -g -y
通过并行13个专家代理进行代码性能审计，检测反模式以优化数据库、内存、算法等瓶颈。遵循先查模式后读代码原则以避免锚定偏差，提供基于最佳实践的优化方案。
请求优化代码或提升应用速度
寻找性能问题或瓶颈
降低延迟
检测代码异味
运行性能或质量审计
npx skills add open-gsd/gsd-pi --skill code-optimizer -g -y
针对 LCP、INP、CLS 三大核心网页指标提供优化方案，涵盖加载速度、交互响应和视觉稳定性，旨在提升用户体验和搜索排名。
improve Core Web Vitals
fix LCP
reduce CLS
optimize INP
page experience optimization
fix layout shifts
npx skills add open-gsd/gsd-pi --skill core-web-vitals -g -y
用于创建、调试和迭代 GSD 扩展（TypeScript 模块），支持添加工具、注册命令、挂钩事件及自定义 UI。提供核心原理、路由指引及开发规范，指导 Agent 构建或修改插件功能。
create/build extension
add a tool
register command
hook into gsd
gsd plugin
npx skills add open-gsd/gsd-pi --skill create-gsd-extension -g -y
用于构建、迭代和评估 Model Context Protocol (MCP) 服务器，将外部服务封装为 LLM 可调用的工具。涵盖工具设计、错误处理、分页及测试评估，旨在提升模型任务完成质量。
构建 MCP 服务器
创建 MCP 工具
将 API 包装为 MCP
扩展 GSD 自定义工具集成
npx skills add open-gsd/gsd-pi --skill create-mcp-server -g -y
提供创建、编写和优化GSD技能的专家指导，涵盖SKILL.md结构、路由模式及最佳实践。
创建新技能
优化现有技能结构
理解技能开发规范
npx skills add open-gsd/gsd-pi --skill create-skill -g -y
指导用户创建符合V1规范的YAML工作流定义，涵盖Schema基础、验证规则、参数替换及路径安全等核心逻辑。
创建新工作流
构建工作流YAML
定义工作流步骤
npx skills add open-gsd/gsd-pi --skill create-workflow -g -y
针对复杂问题的深度调试技能，通过证据收集、假设验证和严格审查定位根因。强调对自写代码保持怀疑，采用科学方法系统性排查，禁止修改代码，适用于标准排错失败的场景。
标准排错失败
需要系统性根因分析
npx skills add open-gsd/gsd-pi --skill debug-like-expert -g -y
将里程碑计划分解为独立可演示的垂直切片，生成依赖有序的ROADMAP文件。强调纵向切割、多薄切片及并行安全，用于任务级拆解与排期。
用户要求“分解计划”或“拆分为切片”
需要制定路线图并细化任务层级
计划切片过厚或缺乏依赖关系
npx skills add open-gsd/gsd-pi --skill decompose-into-slices -g -y
安全批量升级依赖，按风险分级分批执行并验证。适用于更新包、修复漏洞或框架升级场景，确保变更可审计且隔离风险。
请求升级依赖或更新包版本
响应安全漏洞通知
执行框架大版本更新
npx skills add open-gsd/gsd-pi --skill dependency-upgrade -g -y
基于《软件设计哲学》生成3种迥异的接口设计方案，通过并行子代理探索设计空间，对比优劣后给出推荐。适用于模块规划或重构时确定API形状，旨在暴露复杂性而非快速决策。
设计新模块或API的接口形状
重构时发现需要重新切割的接缝
多个调用者即将耦合未设计的接口
npx skills add open-gsd/gsd-pi --skill design-an-interface -g -y
分析GSD自动运行失败原因，通过只读检查运行时日志、指标和锁文件追踪根因，生成包含证据引用和修复建议的Bug报告。
用户询问自动模式为何失败或崩溃
会话意外终止或陷入死循环
手动触发深入排查需求
npx skills add open-gsd/gsd-pi --skill forensics -g -y
指导创建独特、生产级的前端界面，避免通用AI美学。适用于构建网页组件、页面、应用及UI美化，强调大胆的美学方向和精细的代码实现。
构建Web组件或页面
设计仪表盘或着陆页
美化现有Web UI
生成React/Vue/H5布局
npx skills add open-gsd/gsd-pi --skill frontend-design -g -y
基于 ci_monitor.cjs 脚本处理 GitHub Actions CI/CD 工作流，涵盖读取实时语法、监控运行状态、调试失败原因及验证版本。强调使用在线文档而非静态数据，确保操作可观测且准确。
编写或修改 GitHub Actions 工作流文件
排查 CI/CD 流水线失败原因
监控正在运行的工作流状态
检查 Action 版本兼容性
npx skills add open-gsd/gsd-pi --skill github-workflows -g -y
通过单步追问和推荐，压力测试计划或设计，消除模糊假设，确保决策树完全闭合并达成团队对齐，防止执行前出现未决分支。
用户要求 'grill me' 或 'stress-test the plan'
计划缺乏失败模式或存在隐含依赖
用户用词模糊如 'I think' 或 'probably'
npx skills add open-gsd/gsd-pi --skill grill-me -g -y
用于在多轮对话中断或上下文即将耗尽时，创建精准的跨会话交接文件。通过更新状态摘要并生成continue.md，确保后续Agent能快速恢复工作上下文，无需重新推导当前进度。
用户要求暂停、交接或稍后回来
上下文使用量接近预算限制
执行高风险操作前需要保存检查点
长会话结束且任务未完成
npx skills add open-gsd/gsd-pi --skill handoff -g -y
自动检测并运行项目的 Lint 和格式化工具（如 ESLint、Prettier、Biome 等），支持指定路径或仅检查变更文件，提供修复建议。
需要代码风格检查和格式修正
提交前验证代码质量
npx skills add open-gsd/gsd-pi --skill lint -g -y
提供UI组件视觉打磨的设计工程原则，涵盖排版、表面样式、动画及性能优化。用于构建或审查界面细节，解决视觉违和感，提升交互质感与体验细腻度。
make it feel better
feels off
stagger animations
border radius
optical alignment
font smoothing
tabular numbers
box shadows
npx skills add open-gsd/gsd-pi --skill make-interfaces-feel-better -g -y
为无状态 Agent 提供可观测性，通过结构化日志、健康端点和持久化故障状态，使后续 Agent 能自主诊断问题。适用于后台任务、服务器及难以调试的代码重构。
添加日志或指标
构建无人值守子系统
重构难调试代码
排查生产环境可见性问题
npx skills add open-gsd/gsd-pi --skill observability -g -y
基于Vercel工程的React和Next.js性能优化指南，涵盖消除瀑布流、代码分割及服务端性能等规则，用于指导组件编写、代码审查与重构。
编写新的React组件或Next.js页面
实施数据获取逻辑
审查代码以发现性能问题
重构现有React/Next.js代码
优化包体积或加载速度
npx skills add open-gsd/gsd-pi --skill react-best-practices -g -y
用于审查代码变更，涵盖安全、性能、缺陷及质量。支持暂存区、未暂存、特定提交或PR范围的Diff分析，强调只读模式与上下文理解，旨在生产前发现真实问题。
用户请求代码审查
需要检查安全漏洞或Bug风险
评估代码质量与维护性
npx skills add open-gsd/gsd-pi --skill review -g -y
基于代码的威胁建模安全审查技能，采用STRIDE模型分析认证、输入处理等变更，生成包含具体漏洞路径、严重性和修复建议的报告。
执行安全审查或漏洞审计
涉及认证授权或外部接口的变更
用户输入与数据库/文件系统的交互
npx skills add open-gsd/gsd-pi --skill security-review -g -y
将已完成的技术调研（spike）成果转化为项目本地技能，实现知识复用。自动读取调研目录，确认价值后生成SKILL.md并写入指定路径，使AI能自动加载。
wrap up the spike
package this as a skill
make this reusable
turn findings into a skill
npx skills add open-gsd/gsd-pi --skill spike-wrap-up -g -y
TDD技能，指导通过红-绿-重构循环实现功能。每次只写一个测试验证单一行为，确保代码通过后再重构。适用于有明确契约的功能、Bug修复和新模块重构，禁止用于探索性实验或纯UI调整。
要求使用TDD或测试先行开发
执行红-绿-重构流程
带有清晰可观察契约的功能实现
需要编写失败的重现测试以修复Bug
npx skills add open-gsd/gsd-pi --skill tdd -g -y
自动检测项目测试框架，根据参数生成源码测试用例、运行现有测试套件并分析失败结果。适配多种语言和框架的测试规范。
需要为指定文件生成单元测试
需要运行当前项目的测试套件
npx skills add open-gsd/gsd-pi --skill test -g -y
提供Web界面UI/UX最佳实践指南，涵盖动画、CSS、音频、排版等12类规则。用于审查或生成前端代码时参考，确保交互体验与视觉设计符合认知心理学及性能标准。
审查CSS动画实现
检查UX模式与交互细节
验证字体与排版规范
npx skills add open-gsd/gsd-pi --skill userinterface-wiki -g -y
强制在声明任务完成前执行验证，确保基于最新代码的新鲜输出证据。防止在未实际测试或构建的情况下错误宣称工作已完成，适用于提交、PR或标记完成前的检查环节。
准备标记任务或切片为完成时
准备提交代码或创建PR时
准备声称测试通过或构建成功时
npx skills add open-gsd/gsd-pi --skill verify-before-complete -g -y
审查前端UI代码是否符合Web界面设计规范，支持检查可访问性、UX及最佳实践。通过获取最新指南并比对文件内容，输出详细合规性问题。
review my UI
check accessibility
audit design
review UX
check my site against best practices
npx skills add open-gsd/gsd-pi --skill web-design-guidelines -g -y
基于 Google Lighthouse 标准的全面 Web 质量审计技能，涵盖性能、无障碍、SEO 及最佳实践。通过分析代码项目，按严重程度分类问题并提供具体修复建议与代码示例，旨在优化网站整体质量。
audit my site
review web quality
run lighthouse audit
check page quality
optimize my website
npx skills add open-gsd/gsd-pi --skill web-quality-audit -g -y
面向陌生读者的文档协作技能，涵盖提案、技术规格和README。通过上下文收集、结构迭代和读者测试三阶段流程，确保文档具备独立可读性和可操作性。
用户要求撰写或重写文档
功能上线前更新面向用户的文档
编写PR描述或RFC
npx skills add open-gsd/gsd-pi --skill write-docs -g -y
将讨论成果综合为里程碑简报（PRD），写入M###-CONTEXT.md。适用于计划稳定后固化需求、模块设计及交接场景，强调合成而非访谈，输出可执行上下文。
用户要求将对话转化为PRD或起草里程碑简报
规划讨论结束需要固化计划
请求捕获当前上下文以移交工作
npx skills add open-gsd/gsd-pi --skill write-milestone-brief -g -y
该技能由 dynamic-resources 扩展提供，用于动态发现和管理资源。
需要动态加载或管理资源时
npx skills add open-gsd/gsd-pi --skill dynamic-resources -g -y
