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构建状态
运行gsd自动化任务
npx skills add open-gsd/gsd-pi --skill gsd-orchestrator -g -y
提供基于WCAG 2.1标准的Web无障碍审计与改进指南，涵盖POUR原则、合规等级及可感知性实现细节。
improve accessibility
a11y audit
WCAG compliance
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 端点
审查 API 代码或 PR
修改 GraphQL Schema
重构服务间 API 边界
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
用于在开发过程中快速回答基于当前会话上下文的侧边问题，无需调用工具或读取新文件，保持专注并直接返回简洁答案。
询问已读文件中的配置名
查询当前Git分支
确认代码中是否处理了特定情况
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
npx skills add open-gsd/gsd-pi --skill core-web-vitals -g -y
用于创建、调试和迭代 GSD 扩展（TypeScript 模块），支持添加工具、命令、事件钩子及自定义 UI，帮助 LLM 增强能力或修改系统行为。
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 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。
请求分解计划或里程碑
需要垂直切片或任务级拆解
路线图切片过厚或顺序不当
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形状
规划新模块边界
重构时重新切割模块接缝
npx skills add open-gsd/gsd-pi --skill design-an-interface -g -y
分析 GSD 自动模式失败原因，通过读取运行时日志和状态文件追溯根因，生成包含代码引用和修复建议的 Bug 报告。纯只读操作，不修改任何状态或重新运行任务。
用户询问自动模式为何失败或卡住
会话意外终止或进入未知状态
执行 /gsd forensics 命令后需要更深入的分析
npx skills add open-gsd/gsd-pi --skill forensics -g -y
用于创建独特且生产级的前端界面，避免通用AI美学。适用于构建网页组件、页面、应用或美化Web UI，强调大胆的美学方向和精致的代码实现。
构建网站或着陆页
开发React/Vue组件
设计仪表盘或海报
美化现有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
通过单步追问压力测试计划或设计，消除模糊假设，解决决策分支依赖，确保执行前对齐。适用于用户要求审查、压力测试或计划存在未决选项时。
用户要求“grill me”或“stress-test the plan”
计划缺乏失败模式或存在隐含依赖
用户对关键设计使用不确定词汇
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能自主诊断问题。
需要添加日志或监控
构建自动模式代码
开发后台任务或服务器
npx skills add open-gsd/gsd-pi --skill observability -g -y
提供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模型分析认证、输入处理等高风险变更，输出具体漏洞利用场景与修复建议。
请求安全审查或威胁建模
涉及认证、授权或外部接口的代码变更
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
自动检测测试框架，生成源文件测试或运行现有测试套件并分析失败原因。支持按文件路径、run参数或无参数触发，适配多种语言和框架的测试规范。
需要为指定源文件生成测试用例
需要运行现有测试套件并分析结果
需要根据近期变更建议测试范围
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
准备声称构建、测试或修复成功
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
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等。通过收集上下文、迭代结构和读者测试三阶段流程，确保文档可理解且具可操作性，避免路径依赖和冗余解释。
用户要求编写或重写文档
功能发布前需更新文档
需要撰写RFC或PR描述
npx skills add open-gsd/gsd-pi --skill write-docs -g -y
将对话中已确定的计划与架构决策综合为里程碑简报（PRD），生成M###-CONTEXT.md文件，供后续Agent执行，不重新访谈。
用户要求总结讨论内容为PRD或里程碑简报
规划阶段结束需固化方案
需要将上下文移交给人或Agent
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
