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 无障碍审计与改进指南，涵盖 POUR 原则、合规等级及可感知性规范（如图片替代文本、图标命名、色彩对比度），旨在提升内容对残障用户的可用性。
improve accessibility
a11y audit
WCAG compliance
screen reader support
keyboard navigation
make accessible
npx skills add open-gsd/gsd-pi --skill accessibility -g -y
提供AI代理的浏览器自动化CLI工具，支持网页导航、表单填写、截图及数据抓取。适用于需要程序化控制浏览器进行Web交互、测试或数据采集的场景。
打开网站
填写表单
截取网页截图
从页面抓取数据
测试Web应用
自动化浏览器操作
npx skills add open-gsd/gsd-pi --skill agent-browser -g -y
用于设计或审查 HTTP/REST/GraphQL API，涵盖版本控制、分页、错误处理、认证及幂等性。适用于新增端点、重构接口边界或代码审查场景。
设计 API
审查 API
添加新端点
修改 GraphQL Schema
npx skills add open-gsd/gsd-pi --skill api-design -g -y
提供现代Web开发最佳实践，涵盖HTTPS、CSP、安全头、依赖审计及输入净化等安全与代码质量规范。
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。指导如何扩展 LLM 能力并修改系统行为。
创建或构建扩展
添加 LLM 可调用的工具
注册斜杠命令
挂钩 GSD 事件
开发 GSD 插件
npx skills add open-gsd/gsd-pi --skill create-gsd-extension -g -y
用于构建、迭代和评估 MCP 服务器，将外部服务封装为 LLM 可调用的工具。涵盖 Schema 设计、错误处理及测试，旨在通过优化工具描述和响应结构提升模型任务完成能力。
构建 MCP 服务器
创建 MCP 工具
将 API 包装为 MCP
扩展 GSD 自定义工具集成
npx skills add open-gsd/gsd-pi --skill create-mcp-server -g -y
提供创建、编写和优化 GSD Skills 的专业指导，涵盖 SKILL.md 结构规范、路由模式及最佳实践。
创建新的 Skill
优化现有 Skill 结构
理解 SKILL.md 编写规范
npx skills add open-gsd/gsd-pi --skill create-skill -g -y
指导用户创建符合 GSD 引擎规范的 V1 YAML 工作流定义，涵盖 Schema 基础、验证规则、参数替换及输出位置等核心逻辑。
create a workflow
new workflow definition
build a workflow
workflow YAML
define workflow steps
workflow from template
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
将项目计划分解为可独立执行的垂直切片，生成路线图及依赖关系。适用于细化任务、拆分里程碑或准备GitHub Issue，确保切片可演示且支持并行开发。
break this into slices
decompose the plan
vertical slices
break into issues
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 运行时日志、指标和锁文件，定位自动模式失败的根本原因。生成包含证据引用和修复建议的 GitHub Issue 报告，用于排查卡死循环或意外崩溃。
用户要求 'forensics' 或 'post-mortem'
询问 'why did auto-mode fail'
会话以非预期状态结束
自动模式意外退出或卡住
npx skills add open-gsd/gsd-pi --skill forensics -g -y
用于构建高质量、具有独特设计感的生产级前端界面。指导开发者在编码前确立大胆的美学方向，涵盖组件、页面及应用开发，注重排版、色彩、动效与空间布局，避免通用AI审美，生成视觉惊艳且功能完善的代码。
构建Web组件或页面
设计仪表盘或着陆页
美化现有Web UI
npx skills add open-gsd/gsd-pi --skill frontend-design -g -y
提供GitHub Actions CI/CD工作流的实时语法查阅、运行监控与故障排查能力。通过ci_monitor.cjs脚本封装CLI操作，支持查看日志、监控状态及验证版本，确保基于最新文档进行CI配置编写与调试。
编写或修改GitHub Actions工作流文件
排查CI流水线失败原因
监控工作流运行状态
验证Action或Node.js版本
npx skills add open-gsd/gsd-pi --skill github-workflows -g -y
通过单次单问的对抗性访谈，压力测试计划或设计，挖掘隐藏假设与依赖，消除模糊语言，直至所有决策分支明确并达成对齐。
用户要求压力测试计划或设计
计划存在未明确的决策分支或模糊描述
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 和 Format 工具（如 ESLint、Biome、Prettier 等），支持按路径或变更文件执行，提供修复建议及自动修复功能。
用户要求检查代码规范或格式
提交代码前进行静态分析
修复代码风格问题
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能自主诊断问题。适用于后台任务、服务及重构场景。
添加日志或指标
构建无人值守子系统
编写后台作业或服务
修复缺乏可见性的生产Bug
npx skills add open-gsd/gsd-pi --skill observability -g -y
基于Vercel工程的React和Next.js性能优化指南，涵盖消除瀑布流、包体积优化及服务端性能等57条规则，用于指导代码编写、审查与重构以提升应用性能。
编写或重构React组件和Next.js页面
实施数据获取策略
审查代码以发现性能瓶颈
优化包体积或加载速度
npx skills add open-gsd/gsd-pi --skill react-best-practices -g -y
用于审查代码变更，涵盖安全、性能、Bug风险及质量。支持暂存区、未暂存、特定提交或PR差异的只读分析，旨在生产前发现真实问题而非风格瑕疵。
用户请求代码审查
需要检查安全漏洞或性能隐患
提交前或合并前的代码质量检查
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的成果封装为项目级Agent Skill，实现知识复用。通过读取Spike目录、与用户确认价值并生成SKILL.md，使临时调研转化为持久化能力。
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
指导通过红-绿-重构循环进行测试驱动开发，按垂直切片逐步实现功能。强调先写失败测试再写最小代码，禁止在红色状态下重构，适用于有明确接口的功能或Bug修复。
使用TDD
编写测试优先代码
红-绿-重构
构建带有测试的功能
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动画与过渡效果
检查UI组件的交互反馈与音效
优化排版与字体设置
评估用户体验模式如预取与动效原则
npx skills add open-gsd/gsd-pi --skill userinterface-wiki -g -y
强制在声明任务完成前执行实时验证，确保基于最新代码的测试结果或构建日志作为完成依据，防止未经证实的断言。
准备标记任务、切片或里程碑为完成状态时
即将提交代码、推送或创建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
基于 Lighthouse 的 Web 质量审计技能，覆盖性能、无障碍、SEO 等 150+ 项检查。分析代码问题并按严重性分类，提供具体修复建议和代码示例。
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等。通过收集上下文、迭代结构和读者测试三阶段流程，确保文档可理解且可操作，避免硬编码路径。
撰写或重写文档
起草技术方案或RFC
更新README
编写PR描述
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
