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原则、合规级别及可感知性实现细节，如图片Alt文本、图标按钮命名和色彩对比度标准。
improve accessibility
a11y audit
WCAG compliance
screen reader support
keyboard navigation
make accessible
npx skills add open-gsd/gsd-pi --skill accessibility -g -y
提供浏览器自动化CLI，支持AI代理进行网页导航、表单填写、截图及数据抓取。通过快照获取元素引用并执行交互，适用于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 能力增强与交互定制。
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，将外部服务封装为 LLM 可调用的工具。涵盖 Schema 设计、错误处理、分页及评估测试，旨在提升模型任务完成度而非仅协议合规。
构建 MCP Server
创建 MCP 工具
将 API 包装为 MCP
扩展 GSD 自定义工具集成
npx skills add open-gsd/gsd-pi --skill create-mcp-server -g -y
提供创建、编写和优化 GSD 技能的专家指导。涵盖 SKILL.md 结构、路由模式、XML 规范及渐进式披露原则，用于构建模块化文件系统能力。
创建新的技能文件
优化现有技能结构
理解 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
将里程碑计划分解为可独立执行的垂直切片，生成路线图或GitHub Issue，强调薄切片、依赖排序与端到端演示能力。
用户要求“分解计划”、“垂直切片”或“拆分为Issue”
需要细化过粗的路线图或导出任务给协作者
npx skills add open-gsd/gsd-pi --skill decompose-into-slices -g -y
安全、分批地升级项目依赖，按风险分级并逐个验证，防止破坏性更新，生成可审计的提交序列。
upgrade deps
bump packages
fix vulnerabilities
npx skills add open-gsd/gsd-pi --skill dependency-upgrade -g -y
用于为模块或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美学。用于构建网页组件、页面、海报或应用，生成具有鲜明设计风格和高质量代码的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
自动检测项目使用的代码检查与格式化工具（如ESLint、Biome等），对目标文件或变更文件执行 lint/format 操作，支持自动修复并报告问题及修复建议。
需要检查或格式化代码风格
提交前验证代码规范
修复代码格式问题
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差异的只读分析，旨在生产前发现真实问题而非风格细节。
用户请求代码审查
需要检查安全漏洞或Bug
评估代码质量与性能
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并写入.agents/skills/目录。
用户要求总结或打包Spike成果
GSD工作流进入合成阶段
npx skills add open-gsd/gsd-pi --skill spike-wrap-up -g -y
指导通过红-绿-重构循环进行测试驱动开发，针对垂直切片逐次实现功能。适用于明确契约的功能开发、Bug修复及模块重构，强调先写失败测试再写最小代码，严禁在红色状态下重构。
要求使用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动画与过渡效果
检查用户交互体验与视觉设计规范
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及最佳实践。提供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等。通过收集上下文、迭代结构和读者测试三个阶段，确保文档意图清晰且可操作。
用户要求撰写或重写文档
功能上线前需更新用户可见行为文档
需要为非GSD消费者生成公开摘要
提交具有重大意义的PR描述
npx skills add open-gsd/gsd-pi --skill write-docs -g -y
将讨论内容综合为里程碑简报（PRD），生成M###-CONTEXT.md，聚焦业务成果与架构决策而非具体任务。
用户要求'turn this into a PRD'
用户要求'draft a milestone brief'
用户要求'capture this context'
用户要求'write it up'
规划讨论结束需要固化计划时
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
