# PRISM：结构化AI编程工作流的命令与子代理工具集

> 一套为Claude Code和Windsurf设计的AI编程工作流工具集，通过Plan-Research-Implement-Synthesize-Maintain五阶段模型，为AI辅助编程提供系统化方法论。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-30T12:44:11.000Z
- 最近活动: 2026-05-30T12:50:39.627Z
- 热度: 159.9
- 关键词: AI编程, Claude Code, Windsurf, 工作流, 子代理, 代码审查, 项目管理, 开发工具
- 页面链接: https://www.zingnex.cn/forum/thread/prism-ai-b2974285
- Canonical: https://www.zingnex.cn/forum/thread/prism-ai-b2974285
- Markdown 来源: ingested_event

---

# PRISM：结构化AI编程工作流的命令与子代理工具集

随着AI编程助手能力的不断提升，如何有效地组织与AI的协作流程成为了一个关键问题。许多开发者发现，简单地让AI"写代码"往往导致代码质量不稳定、上下文丢失、以及难以维护的代码库。PRISM项目正是为了解决这些问题而诞生——它提供了一套结构化的命令、子代理和技能工具集，将AI编程工作流划分为五个明确的阶段，帮助开发者建立可重复、可维护的AI协作模式。

## 原作者与来源

- **原作者/维护者**: colinfwalsh
- **来源平台**: GitHub
- **原始标题**: PRISM
- **原始链接**: https://github.com/colinfwalsh/PRISM
- **发布时间**: 2026年5月30日
- **许可证**: Apache License 2.0

## PRISM的核心理念

PRISM这个名字来源于其定义的五个工作阶段的首字母缩写：

- **P**lan（规划）：制定详细的、基于代码库的实施方案
- **R**esearch（研究）：记录代码库的当前状态——定位、分析、发现模式
- **I**mplement（实现）：用小型、定义明确的编码单元执行已批准的方案
- **S**ynthesize（综合）：在会话间传递上下文、恢复工作、捕获决策
- **M**aintain（维护）：验证实现是否符合方案；在本地审查同事的代码分支

这一模型反映了资深软件工程师的实际工作方式：他们不会立即开始编码，而是先理解问题、研究现有代码、制定计划，然后才动手实现。PRISM将这一经验性流程工具化，让AI助手也能遵循同样的专业实践。

## 命令系统详解

PRISM安装了一系列斜杠命令（在Claude Code中使用`/<name>`调用，在Windsurf中作为工作流使用）：

### 规划阶段命令

**`/create_plan`**：交互式构建基于代码库的详细实施方案。这个命令会引导用户逐步定义目标、识别相关文件、规划变更步骤，最终生成一个结构化的计划文档。该命令使用opus模型以获得更强的规划能力。

**`/iterate_plan`**：根据反馈更新现有计划，确保计划始终与代码库的实际状态保持一致。当代码库在计划制定后发生变化时，这个命令特别有用。

### 研究阶段命令

**`/research_codebase`**：通过并行的子代理记录代码库的当前状态。这个命令会自动分派多个专业代理来探索代码库的不同部分，然后整合它们的研究结果。同样使用opus模型以获得深度分析能力。

### 实现阶段命令

**`/implement_plan`**：按阶段执行已批准的计划，并在每个阶段进行验证。这个命令是连接规划与执行的关键桥梁，确保实现严格遵循预定的方案。

### 综合阶段命令

**`/create_handoff`**：编写简洁的交接文档，用于将工作转移到另一个会话。这在长时间任务或需要切换上下文时特别重要，可以防止信息丢失。

**`/resume_handoff`**：从交接文档中恢复工作，重建上下文。这让AI助手能够像人类开发者一样"接力"完成复杂任务。

### 维护阶段命令

**`/validate_plan`**：验证实现是否符合其计划，并突出显示偏差。这是质量保证的关键步骤，确保AI生成的代码符合原始意图。

**`/local_review`**：设置工作树以在本地审查同事的代码分支。支持`gh_username:branchName`格式的参数，简化了代码审查流程。

## 子代理系统（Claude Code专属）

PRISM定义了一组专业子代理，每个代理都有明确的职责和适用场景：

### 架构与实现代理

**`architecture-agent`**（使用opus模型）：负责做出模式/设计判断，将广泛的工作分解为适合coder-agent处理的子任务。这是一个只读代理，专注于决策而非执行。

**`coder-agent`**（使用sonnet模型）：实现小型、定义明确的编码任务，具有精确的规范和验收标准。这是实际执行代码变更的主力代理。

### 代码库研究代理

**`codebase-locator`**：定位代码所在位置——文件、目录、组件。这是研究阶段的第一步。

**`codebase-analyzer`**：解释代码如何工作，提供文件:行号引用。作为文档记录者而非批评者，它专注于描述现状而非推荐变更。

**`codebase-pattern-finder`**：展示现有模式的具体示例，为新的工作提供参考模型。这有助于保持代码风格的一致性。

### 文档研究代理

**`thoughts-locator`**：在`~/thoughts/`目录中发现相关文档。

**`thoughts-analyzer`**：深入分析特定的thoughts文档，提取关键洞察。

### 外部研究代理

**`web-search-researcher`**：通过WebSearch和WebFetch进行外部研究。这在需要了解最新技术或外部库的使用方式时特别有用。

值得注意的是，研究/分析类代理被严格设计为"文档记录者"——它们描述现状而非推荐变更。而architecture-agent和coder-agent则是"行动导向"的组合：架构师负责决策和分解，编码者负责执行。这种分离确保了研究和实施的清晰界限。

## 技能系统：rlm-recursive-context

PRISM包含一个名为`rlm-recursive-context`的技能，它实现了"递归语言模型"风格的输入处理方式。当输入内容过长无法一次性处理时，这个技能会：

1. 将长输入视为外部对象
2. 对其进行切片
3. 从子调用变量中拼接结果

这种处理方式类似于人类阅读长文档时会分段理解、然后整合认知的过程。对于处理大型代码库或长文档特别有用。

## 工作空间组织

PRISM命令将长期存在的规划工件保存在`~/thoughts/{project_name}/`目录下，其中`{project_name}`是当前工作目录的basename。子目录包括：

- `~/thoughts/{project_name}/research/` —— 研究文档
- `~/thoughts/{project_name}/plans/` —— 实施方案
- `~/thoughts/{project_name}/tickets/` —— 任务工单
- `~/thoughts/{project_name}/handoffs/` —— 交接文档

这种组织方式将规划工件与项目仓库分离，同时保持按项目范围的管理。这避免了将临时规划文件提交到版本控制的问题。

## 安装与兼容性

PRISM支持两种主流AI编程工具：

**Claude Code**：完整支持命令、子代理和技能
- 命令安装到`~/.claude/commands/`
- 代理安装到`~/.claude/agents/`
- 技能安装到`~/.claude/skills/`

**Windsurf**：仅支持命令（作为工作流安装）
- 命令安装到`./.windsurf/workflows/`
- Windsurf原生不支持子代理和技能

安装脚本提供了灵活的选项：

```bash
./install.sh              # 交互式提示
./install.sh --claude     # 仅安装Claude Code
./install.sh --windsurf   # 仅安装Windsurf工作流
./install.sh --all        # 安装到所有支持的位置
```

现有文件会被重命名为`<name>.bak.<timestamp>`，确保重新安装不会破坏用户数据。

## 典型工作流程示例

一个典型的PRISM会话会沿着PRISM的五个阶段进行：

1. **Research** —— 使用`/research_codebase`（或直接使用codebase-locator + codebase-analyzer）绘制相关区域的地图

2. **Plan** —— 使用`/create_plan`生成阶段性计划；使用`/iterate_plan`进行细化

3. **Implement** —— `/implement_plan`驱动执行，委托给architecture-agent和coder-agent进行实际编辑

4. **Synthesize** —— 会话结束时使用`/create_handoff`；下次会话开始时使用`/resume_handoff`

5. **Maintain** —— 使用`/validate_plan`确认实现符合计划；使用`/local_review`在隔离的工作树中审查同事的代码分支

这种结构化的流程确保了AI编程的可控性和可维护性，避免了"一次性代码"的问题。

## 总结与思考

PRISM项目代表了一种重要的趋势：AI编程工具正在从"智能自动补全"向"结构化协作伙伴"演进。通过定义清晰的工作阶段和专业化的代理角色，PRISM让AI助手能够模拟资深开发者的工作方式。

对于团队而言，PRISM提供了一种可重复的AI协作模式，有助于在组织内建立一致的AI使用规范。对于个人开发者，它提供了一个学习结构化编程思维的框架。

随着AI能力的持续提升，如何有效地组织人机协作将成为软件开发的核心竞争力之一。PRISM的PRISM方法论——Plan-Research-Implement-Synthesize-Maintain——提供了一个经过深思熟虑的答案，值得每一位使用AI编程工具的开发者参考。