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的网页无障碍审计与改进指南，涵盖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 契约。
design an API
review this API
add a new endpoint
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
用于在开发过程中快速提出与当前上下文相关的辅助性问题，仅基于已有会话信息作答，不调用工具或读取文件，保持简短并迅速回归主任务。
需要快速确认已读文件中的细节
询问当前会话中已建立的代码或决策背景
npx skills add open-gsd/gsd-pi --skill btw -g -y
通过13个并行专家Agent进行深度代码性能审计，利用模式匹配检测反模式并优化性能瓶颈。
请求优化代码或提升应用速度
查找性能问题、延迟或瓶颈
运行代码质量与性能审计
npx skills add open-gsd/gsd-pi --skill code-optimizer -g -y
针对LCP、INP、CLS三大核心Web指标提供优化方案，涵盖加载、交互与视觉稳定性。通过代码示例指导减少渲染阻塞、预加载资源及服务端渲染，以提升页面体验与搜索排名。
improve Core Web Vitals
fix LCP
reduce CLS
optimize INP
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 Server，将外部 API 封装为 LLM 可调用的工具。涵盖工具设计、错误处理、分页及评估测试，旨在通过优化描述和响应结构提升模型任务完成率。
build an MCP server
create an MCP tool
wrap this API as MCP
expose X to Claude
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工作流定义。涵盖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，强调端到端交付、并行安全与依赖排序。
要求分解计划或任务
需要将方案细化为具体执行步骤
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'
询问自动模式为何失败或卡死
/gsd forensics 命令后需要更深入分析
会话意外终止或崩溃
npx skills add open-gsd/gsd-pi --skill forensics -g -y
指导创建具有独特设计感的生产级前端界面，避免通用AI美学。适用于构建Web组件、页面、海报及应用，强调大胆的美学方向、排版、色彩与动效细节，生成视觉惊艳且功能完备的代码。
构建Web组件或页面
生成HTML/CSS/JS布局
美化或重新设计Web UI
创建React/Vue组件
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
通过单轮追问压力测试计划或设计，逐一解决决策分支，消除模糊假设并达成对齐。
用户要求“grill me”或压力测试计划
计划缺乏失败模式或存在未决依赖
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
自动检测并运行项目的代码检查与格式化工具，支持ESLint、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能独立诊断问题。适用于后台任务、服务器及重构场景。
添加日志或可观测性
构建自动模式引擎或后台作业
编写长期运行的进程或服务
重构难以调试的子系统
解决因缺乏可见性导致的线上故障
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
用于审查代码变更，涵盖安全、性能、Bug及质量。支持暂存区、未暂存、特定提交或PR差异的只读分析，聚焦真实问题而非风格细节。
用户请求审查代码变更
检查Git暂存区或未暂存更改
评估Pull Request差异
npx skills add open-gsd/gsd-pi --skill review -g -y
基于代码的威胁建模安全审查，通过STRIDE模型分析认证、输入处理等风险点，输出包含具体利用场景和修复建议的可执行报告。
要求进行安全审查或威胁建模
涉及身份验证、授权、会话处理的变更
用户输入对接数据库或文件系统
暴露新的外部接口如HTTP端点或Webhook
密钥管理或加密代码变更
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组件的交互动画与缓动函数
评估排版、图标或音频反馈实现
验证UX设计原则如Fitts定律应用
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
基于 Google Lighthouse 标准，对网站性能、无障碍、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。通过收集上下文、迭代结构和读者测试三阶段流程，确保文档意图清晰且可操作。
用户要求编写或重写文档
功能上线前更新用户-facing文档
编写RFC、PR描述或运行手册
npx skills add open-gsd/gsd-pi --skill write-docs -g -y
将当前对话中已确定的计划综合为里程碑简报（PRD），生成持久化的上下文文档，供后续执行使用。不重新访谈，仅提炼已有决策与模块设计。
用户要求将讨论转化为 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
