@the-agency/pi-spec-kit
为Pi Agent集成GitHub Spec Kit，实现规范驱动的软件开发流程。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@the-agency/pi-spec-kit。 它的用途是：为Pi Agent集成GitHub Spec Kit，实现规范驱动的软件开发流程。 完整的 Skill 内容见：https://321skill.com/skills/the-agency-pi-spec-kit/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“基于 `specs/new-checkout-flow.md` 这份规范，为新的结账流程创建实现分支并生成初始代码。” 它会解析该规范文档，理解功能需求、验收标准和架构设计，然后自动创建对应的Git分支，并生成符合规范的核心模块代码框架。
介绍
这个Skill解决了在软件开发中，功能规划与代码实现之间容易脱节、文档与开发不同步的问题。它通过将GitHub官方的Spec Kit工具深度集成到Pi Agent中，允许开发者直接在代码仓库内，以编写和遵循规范文档（Spec）的方式来驱动整个功能的规划、讨论与构建过程。
使用方式是在Pi Agent中安装此包，然后在你的项目仓库中，遵循Spec Kit的格式创建功能规范文档。之后，你可以指令Pi Agent基于这份规范文档来生成代码、创建分支、提交PR，或者根据规范的更新来同步调整代码实现，从而将文档作为开发的唯一事实来源。
它非常适合遵循严谨开发流程的团队，尤其是那些已经在使用或希望尝试GitHub Issues、Projects和Pull Requests进行项目管理的软件工程师、技术负责人和项目经理。对于希望提升代码与设计文档一致性、减少沟通成本的项目来说，这是一个理想工具。
建议在使用前，先熟悉GitHub Spec Kit的基本概念和文档格式。由于它深度绑定Pi和GitHub的工作流，因此更适合在GitHub托管且团队已使用Pi Agent的项目中实施。注意，它不是一个独立的UI工具，其能力完全通过Pi Agent的对话来触发和执行。
核心特点
核心区别在于，它并非简单封装Spec Kit的API，而是以“Pi原生”的方式深度集成，让Spec Kit的规范驱动工作流成为Pi Agent可理解、可执行的内部指令，从而在AI辅助编程的上下文中无缝衔接规划与开发。
注意事项
不适合不采用GitHub平台或不使用Spec Kit规范格式进行项目管理的团队或个人。
常见问题
Pi Spec Kit 和 GitHub 原版 Spec Kit 有什么区别？
Pi Spec Kit 是让 Pi Agent 能理解并执行 Spec Kit 工作流的插件，而原版 Spec Kit 是一套供人使用的工具和规范。
需要单独安装 GitHub Spec Kit 吗？
不需要，此包已集成必要逻辑，你只需在仓库中按照 Spec Kit 格式创建文档即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/the-agency-pi-spec-kit/raw/index.md 读取 @the-agency/pi-spec-kit 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/the-agency-pi-spec-kit/raw/index.md（查看排版版本）