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 (38)
通过编排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
screen reader support
keyboard navigation
make accessible
npx skills add open-gsd/gsd-pi --skill accessibility -g -y
提供AI代理的浏览器自动化CLI工具，支持网页导航、表单填写、点击交互、截图及数据抓取。适用于测试Web应用或程序化操作网站等场景。
open a website
fill out a form
take a screenshot
scrape data from a page
test this web app
automate browser actions
npx skills add open-gsd/gsd-pi --skill agent-browser -g -y
用于设计或审查 HTTP/REST/GraphQL API，涵盖版本控制、分页、错误处理、幂等性及鉴权等核心规范。旨在构建可演进、语义诚实且面向长期客户端的接口契约。
设计新的 API 端点
审查现有 API 接口
修改 GraphQL Schema
定义内部服务间 HTTP 边界
npx skills add open-gsd/gsd-pi --skill api-design -g -y
提供现代Web开发最佳实践，涵盖HTTPS、CSP、安全头、依赖审计及输入清洗等，用于代码质量审查、安全审计和漏洞检查。
应用最佳实践
安全审计
现代化代码
代码质量审查
检查漏洞
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
npx skills add open-gsd/gsd-pi --skill core-web-vitals -g -y
用于创建、调试和迭代 GSD 扩展（TypeScript 模块），支持添加工具、注册命令、挂钩事件及自定义 UI。
创建或构建扩展
添加 LLM 可调用的工具
注册斜杠命令
挂钩 GSD 事件
创建自定义 TUI 组件
npx skills add open-gsd/gsd-pi --skill create-gsd-extension -g -y
构建高质量的 MCP 服务器，将外部服务封装为 LLM 可调用的工具。涵盖 Schema 设计、错误处理、分页及评估测试，确保工具描述和交互逻辑优化模型推理能力，而非仅满足协议规范。
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 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
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。
要求将计划分解为切片
需要细化里程碑任务
请求创建垂直切片
需将计划转为 GitHub Issue
npx skills add open-gsd/gsd-pi --skill decompose-into-slices -g -y
系统化执行依赖升级，按风险分级分批处理，每批后验证并隔离提交，确保升级安全可追溯。
请求升级依赖包或修复漏洞
框架大版本更新如React/Node升级
响应安全CVE通告
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 报告，适用于故障复盘和异常状态排查。
GSD 自动模式意外退出或卡死
用户请求进行事后分析或根因追踪
/gsd forensics 命令触发后的深度调查
检测到重复调度导致的死循环
npx skills add open-gsd/gsd-pi --skill forensics -g -y
指导创建独特且生产级的前端界面，避免通用AI美学。适用于构建网页组件、页面、应用及UI美化，强调大胆的美学方向和精细的代码实现。
构建Web组件或页面
设计仪表盘或着陆页
美化任何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”或“interrogate my design”
计划描述过于理想化，缺乏失败模式处理
多个计划部分隐式依赖于未决定的选择
用户对关键设计使用“probably”等模糊词汇
npx skills add open-gsd/gsd-pi --skill grill-me -g -y
用于在多会话间交接工作状态，保存检查点以恢复上下文。当用户请求暂停、手递或上下文即将耗尽时触发，确保后续Agent能高效接续任务。
用户要求'hand off'或'pause'
上下文预算即将耗尽
执行高风险操作前需保留状态
npx skills add open-gsd/gsd-pi --skill handoff -g -y
自动检测并运行项目代码的 Lint 和格式化，支持 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
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差异，强调只读分析，聚焦真实问题而非风格细节。
用户请求审查代码变更
检查暂存或未暂存的Git更改
评估Pull Request前的代码质量
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）成果封装为项目本地技能，实现知识复用。通过读取工作流文档并确认用户意图，生成可自动加载的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或测试优先开发
执行红-绿-重构流程
基于明确行为契约构建功能
编写复现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
npx skills add open-gsd/gsd-pi --skill web-design-guidelines -g -y
基于Google 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等。通过收集上下文、迭代结构和读者测试三阶段流程，确保文档意图清晰且可操作。
用户要求撰写或重写文档
功能上线前更新用户-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
指导Agent正确处理GSD运行中的阻塞与失败恢复，明确人类终端审批阻断器的唯一性及任务恢复的 gated 机制，防止非法状态篡改或自动绕过安全限制。
GSD运行被阻塞或暂停
Task尝试失败且存在恢复动作
用户请求清除阻塞、解除暂停或恢复失败任务
npx skills add open-gsd/gsd-pi --skill gsd-blocker-recovery -g -y
通过 dynamic-resources 扩展动态加载资源发现技能，支持在运行时灵活接入外部资源或配置。
需要动态加载资源时
使用 resources_discover 扩展时
npx skills add open-gsd/gsd-pi --skill dynamic-resources -g -y
