Shipkit：Claude Code的AI辅助产品开发框架与38个技能体系

本文介绍Shipkit——专为Claude Code设计的AI辅助产品开发框架，包含38个技能、11个智能体角色和完整的工作流编排系统，帮助团队从愿景定义到产品交付的全流程加速。

Shipkit的目标是让团队能够更快地交付MVP（最小可行产品）。它不是简单的提示词集合，而是一个结构化的工作流框架，涵盖了产品开发的完整生命周期：从战略愿景的定义，到产品发现、规格制定、实现规划，再到最终的交付和质量验证。

框架的核心设计哲学是将AI作为协作伙伴而非替代工具。每个技能都经过精心设计，确保人类决策者始终掌握主导权，同时充分利用AI在信息处理、模式识别和代码生成方面的优势。

Shipkit包含38个技能，按功能域组织为七个类别：

愿景与发现（12个技能）：包括why-project（项目愿景定义）、product-discovery（产品发现）、project-context（项目上下文）、design-system（设计系统）等，帮助团队在动手编码前充分理解问题空间和用户需求。

规格与规划（5个技能）：spec-roadmap（规格路线图）、spec（功能规格）、feedback-bug（反馈处理）等，将发现阶段的洞察转化为可执行的开发计划。

知识与记忆（2个技能）：claude-md（CLAUDE.md管理）和work-memory（工作记忆），确保AI助手能够持续学习和积累项目特定的上下文。

编排（3个技能）：orch-direction（方向编排）、orch-planning（规划编排）、orch-shipping（交付编排），提供工作流的高级协调机制。

执行（1个技能）：test-cases（测试用例生成），将规格转化为可验证的测试场景。

质量与沟通（11个技能）：review-direction（方向评审）、review-planning（规划评审）、review-shipping（交付评审）、preflight（MVP生产就绪审计）、scale-ready（规模化就绪审计）、prompt-audit（提示词架构审计）、semantic-qa（语义QA）、ux-audit（UX分析）等，构建全面的质量保证体系。

系统（3个技能）：update（框架更新）、get-skills（技能发现）、get-mcps（MCP服务器发现），维护框架自身的可进化性。

Shipkit定义了四个核心工作流技能，构成产品开发的骨架：

shipkit-master：元技能，负责整个工作流的编排。它理解项目当前所处阶段，决定调用哪个子技能推进工作。

shipkit-project-context：代码库扫描和栈检测技能，自动分析项目结构、识别技术栈、提取关键配置信息，为后续技能提供上下文基础。

shipkit-codebase-index：语义代码库索引技能，构建代码的语义表示，支持基于意图的代码检索和导航。

shipkit-claude-md：CLAUDE.md管理技能，维护项目特定的AI助手配置，包括编码规范、架构决策、团队偏好等持久化知识。

Shipkit的核心工作流遵循方向-规划-交付的三阶段循环：

方向编排（orch-direction）：聚焦战略层面的决策，包括产品愿景、目标用户、核心价值主张、业务目标等。此阶段产出战略工件，并进行一致性评审。

规划编排（orch-planning）：将战略方向转化为具体可执行的规划，包括产品定义、工程定义、规格制定、里程碑设定等。此阶段产出规划工件，并进行对齐评审。

交付编排（orch-shipping）：执行具体的实现和验证工作，包括编码、测试、代码评审、发布检查等。此阶段产出可交付的软件，并进行质量评审。

每个编排阶段都有对应的智能体角色负责协调，确保工作流的有序推进。

Shipkit定义了11个智能体角色，分为三类：

编排者（Orchestrators）：orch-master-agent（主循环编排者）、orch-direction-agent（方向循环编排者）、orch-planning-agent（规划循环编排者）、orch-shipping-agent（交付循环编排者）。这些智能体负责工作流的顺序调度和阶段推进。

生产者（Producers）：visionary-agent（战略愿景制定者）、product-owner-agent（产品经理）、architect-agent（工程架构师）、thinking-partner-agent（思维伙伴）。这些智能体专注于特定领域的深度工作，产出高质量的工件。

评审者（Reviewers）：reviewer-direction-agent（方向评审者）、reviewer-planning-agent（规划评审者）、reviewer-shipping-agent（交付评审者）。这些智能体负责质量把关，从不同维度评估工件的完整性和一致性。

使用Shipkit非常简单，一行命令即可初始化：

cd your-project
npx shipkit-dev init

初始化后，项目将获得以下结构：

• CLAUDE.md：用户偏好和学习记录，可手动编辑
• .claude/：Claude Code配置目录，包含settings.json、规则文件、技能定义、智能体定义和会话钩子
• .shipkit/：Shipkit工作区，包含specs（规格）、plans（规划）和上下文文件

这种结构确保了AI助手能够持续学习项目特定的知识，同时保持配置的可版本控制和团队协作友好。

Shipkit提供了灵活的使用模式。对于已有明确方向的项目，可以直接从/shipkit-spec开始，跳过完整的发现链。发现链（why → discovery → product-definition → engineering-definition → goals）对于新产品或探索性问题空间最为有价值。

框架还提供了丰富的快捷命令，如/shipkit-vision直接进入愿景制定，/shipkit-spec快速创建功能规格，/shipkit-review-shipping进行交付前评审等。