pi-stack-ops
基于规范与ADR的堆叠式PR工作流管理工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-stack-ops。 它的用途是：基于规范与ADR的堆叠式PR工作流管理工具。 完整的 Skill 内容见：https://321skill.com/skills/pi-stack-ops/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“基于‘用户认证微服务重构’的ADR文档#123，为我初始化一个堆叠PR工作流。”，它会解析ADR内容，自动创建首个基础PR，并为你规划好后续依赖PR的结构和初始描述。当你完成第一层代码后，可以指令它：“创建下一个堆叠PR，依赖于当前PR#456，实现OAuth模块。”
介绍
pi-stack-ops 旨在解决在复杂项目开发中，特别是涉及多个相互依赖的更改（堆叠式PR）时，工作流管理混乱、上下文丢失和协作效率低下的问题。它通过将设计规范（spec）和架构决策记录（ADR）作为驱动核心，确保每个PR及其堆叠关系都有明确的依据和文档支持，从而提升代码变更的可追溯性和团队共识。
使用该工具时，开发者需要先编写或引用相关的spec/ADR文档，然后通过pi-stack-ops的命令或API来创建、关联和管理一系列堆叠的PR。工具会帮助维护PR之间的依赖链，并可能集成专门的AI Agent来辅助进行代码审查、依赖分析或状态同步，使得处理多层更改像处理单个PR一样清晰。
它非常适合采用Trunk-Based开发模式、需要频繁处理功能分支链的中大型团队，或者任何希望将设计决策与代码实现更紧密绑定，追求工程严谨性的项目。对于开源项目维护者或技术负责人，这也是一个强化代码审查流程的好帮手。
建议在引入前确保团队已初步建立编写spec或ADR的习惯，并准备好相应的文档仓库。注意，工具可能对现有CI/CD流程有一定侵入性，需要预先评估和适配。对于小型或快速迭代的原型项目，其流程可能略显繁重。
核心特点
其核心在于“Stax-first”和“spec/ADR-led”设计，强制要求堆叠式PR工作流以书面设计和架构决策为前置输入和唯一依据，而同类工具多侧重于分支/PR的机械管理或事后补录文档。
注意事项
不适合设计文档尚不完善或追求极致轻量、快速单次PR发布的超小型敏捷团队。
常见问题
pi-stack-ops 和传统的Git分支管理工具有什么不同？
它专为管理有明确依赖关系的“堆叠PR”设计，并以spec/ADR文档为驱动核心，而非简单的分支创建与合并。
是否需要额外的文档系统来配合使用？
是的，需要有一个存放spec和ADR文档的仓库（如GitHub Wiki、独立Repo），工具会与之联动。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-stack-ops/raw/index.md 读取 pi-stack-ops 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-stack-ops/raw/index.md（查看排版版本）