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和安全头、审计依赖漏洞及防止XSS等安全问题。
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
用于优化 Core Web Vitals (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。指导开发者注册功能、处理状态并遵循核心规则。
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
构建高质量 MCP 服务器，将外部服务封装为 LLM 可调用的工具。涵盖协议规范、Schema 设计、错误处理及模型导向的工具优化，确保提升任务完成度而非仅满足协议合规。
构建 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
指导用户创建符合GSD引擎规范的V1 YAML工作流定义，涵盖结构、验证规则及输出路径。
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，确保并行安全与依赖关系。
要求将计划拆分为切片
需要任务级分解
创建里程碑后的细化
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报告。仅读取数据，不修改状态或重跑任务。
用户请求“forensics”或“post-mortem”
自动模式意外停止或崩溃
检测到循环卡住或重复分发单元
会话异常结束且存在残留锁
npx skills add open-gsd/gsd-pi --skill forensics -g -y
指导创建具有独特设计感的生产级前端界面，避免通用AI美学。适用于构建Web组件、页面、应用及UI美化，强调大胆的美学方向和精致的代码实现。
构建网页组件或页面
制作海报或应用程序
设计仪表盘或落地页
优化和美化现有Web UI
npx skills add open-gsd/gsd-pi --skill frontend-design -g -y
专注 GitHub Actions CI/CD 工作流的读取、监控与调试。通过 ci_monitor.cjs 工具实时获取语法，避免过时数据，支持查看运行状态、分析失败日志及验证版本，确保工作流编写与排查的准确性。
编写或修改 GitHub Actions 工作流文件
监控 CI/CD 任务运行状态
调试工作流执行失败原因
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 命令
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能独立诊断问题。核心原则是记录决策而非活动，失败时 loudly 并持久化原因，避免静默吞没异常。
构建自动模式代码（循环、分发、守卫）
添加后台任务或长运行进程
重构难以调试的子系统
解决因缺乏可见性导致的线上Bug
npx skills add open-gsd/gsd-pi --skill observability -g -y
基于Vercel工程的React/Next.js性能优化指南，涵盖消除数据瀑布、包体积优化及服务端渲染等57条规则，用于指导代码编写、审查与重构。
编写新的React组件或Next.js页面
实施客户端或服务端数据获取逻辑
审查代码以发现性能瓶颈
重构现有React/Next.js代码以提升性能
优化应用包体积或加载速度
npx skills add open-gsd/gsd-pi --skill react-best-practices -g -y
代码审查技能，聚焦安全、性能、Bug及质量。支持暂存区、未暂存、特定提交或PR变更的只读分析，提供结构化反馈，避免风格琐事，确保生产环境前捕获真实问题。
请求审查代码变更
检查PR合并前的差异
npx skills add open-gsd/gsd-pi --skill review -g -y
基于代码的威胁建模安全审查技能，执行STRIDE分析，识别具体漏洞并提供修复建议。适用于涉及认证、输入处理或外部接口的变更审计。
security review
threat model
check for vulnerabilities
audit for security
secure this
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
用于审查Web界面代码是否符合设计规范与最佳实践。通过获取最新指南并对照检查文件，输出合规性发现，适用于UI、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等。通过收集上下文、迭代结构和读者测试三阶段流程，确保文档具备独立可读性并指导行动。
用户要求撰写或重写文档
功能上线前需更新用户可见文档
编写RFC、PR描述或公共文档
npx skills add open-gsd/gsd-pi --skill write-docs -g -y
将当前对话讨论内容综合为里程碑简报（PRD），写入M###-CONTEXT.md。该技能用于在规划阶段结束时固化已达成共识的方案，描述最终成果、场景及架构决策，而非罗列任务步骤，以便后续Agent执行时无需额外上下文。
用户要求将讨论转化为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
