# OpenSpec Extended：为 AI 编程助手打造的自主实现框架

> OpenSpec Extended 是 OpenSpec 的扩展包，添加了七阶段自主实现工作流、三个专业代理和六个实用技能，让 AI 编程助手能够端到端地完成复杂开发任务。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-10T16:45:04.000Z
- 最近活动: 2026-06-10T16:53:40.224Z
- 热度: 116.9
- 关键词: OpenSpec, AI编程助手, 自主实现, 七阶段工作流, 专业代理, 代码生成, 软件开发, Bash, AI辅助开发
- 页面链接: https://www.zingnex.cn/forum/thread/openspec-extended-ai
- Canonical: https://www.zingnex.cn/forum/thread/openspec-extended-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：amauryconstant
- 来源平台：github
- 原始标题：openspec-extended
- 原始链接：https://github.com/amauryconstant/openspec-extended
- 来源发布时间/更新时间：2026-06-10T16:45:04Z

## 原作者与来源\n\n- **原作者/维护者：** amauryconstant\n- **来源平台：** GitHub\n- **原始标题：** openspec-extended\n- **原始链接：** https://github.com/amauryconstant/openspec-extended\n- **发布时间：** 2026年6月10日\n\n---\n\n## 项目背景：OpenSpec 的进化\n\nOpenSpec 是一个为 AI 编程助手设计的框架，旨在规范化 AI 辅助软件开发的过程。然而，原版的 OpenSpec 主要提供手动变更工作流——开发者需要逐步指导 AI 完成每个阶段。\n\nOpenSpec Extended 在此基础上进行了重大扩展，引入了**自主实现能力**。这意味着 AI 代理可以在没有人工干预的情况下，端到端地完成复杂开发任务。这对于希望提高生产力的开发团队来说是一个重要的进步。\n\n---\n\n## 核心对比：Extended 带来了什么？\n\n| 特性 | OpenSpec Core | OpenSpec Extended |\n|------|---------------|-------------------|\n| 手动变更工作流 | ✓ 11 个命令 | ✓（通过 `--with-core`） |\n| 自主实现 | ✗ | ✓ 七阶段循环 |\n| 专业代理 | ✗ | ✓ 3 个代理 |\n| 实用技能 | ✗ | ✓ 6 个技能 |\n\n这种对比清晰地展示了 Extended 的定位：它不是取代 OpenSpec Core，而是在其基础上增加自主能力，让开发者可以根据任务复杂度选择合适的工作模式。\n\n---\n\n## 七阶段自主工作流\n\nOpenSpec Extended 的核心是 `osx-orchestrate` 脚本，它实现了七阶段自主实现循环：\n\n### 阶段 0：审查（Review）\n\n分析现有工件，理解当前代码库的状态和结构。代理会读取相关文件，建立对项目的整体认知。\n\n### 阶段 1：构建（Build）\n\n根据变更需求实现具体任务。这是主要的编码阶段，代理会创建、修改文件，执行实际的开发工作。\n\n### 阶段 2：验证（Verify）\n\n验证实现是否正确。代理会运行测试、检查代码质量，确保变更符合预期。\n\n### 阶段 3：文档（Docs）\n\n更新相关文档。包括代码注释、README、API 文档等，确保文档与代码同步。\n\n### 阶段 4：同步（Sync）\n\n与上游代码库同步。代理会检查是否有冲突，必要时进行合并操作。\n\n### 阶段 5：反思（Reflect）\n\n自我评估。代理会回顾整个变更过程，识别潜在问题和改进空间。\n\n### 阶段 6：归档（Archive）\n\n归档已完成的变更。状态文件会被移动到归档目录，保留历史记录供将来参考。\n\n---\n\n## 三个专业代理\n\nOpenSpec Extended 定义了三个专门化的代理，每个都有特定的职责和工具集：\n\n### 1. osx-analyzer（分析器）\n\n- **用途**：审查、验证、反思\n- **工具**：read、grep、glob、bash\n- **温度**：0.1（低随机性，更确定性）\n\n分析器代理专注于理解和评估。它不会修改文件，而是仔细阅读代码，提供分析和建议。低温度设置确保其输出稳定、可预测。\n\n### 2. osx-builder（构建器）\n\n- **用途**：实现\n- **工具**：read、grep、glob、bash、write、edit\n- **温度**：0.4（适度创造性）\n\n构建器代理是唯一拥有写权限的代理。它负责实际的编码工作，创建新文件、修改现有代码。适度的温度设置允许一定的创造性，同时保持代码质量。\n\n### 3. osx-maintainer（维护者）\n\n- **用途**：文档、同步、归档\n- **工具**：read、grep、glob、bash、write、edit\n- **温度**：0.3（平衡创造性和一致性）\n\n维护者代理专注于保持项目的健康状态，处理文档更新、代码同步和变更归档。\n\n这种分工设计体现了软件工程的最佳实践：不同的任务由不同的"角色"处理，每个角色都有明确的权限和责任边界。\n\n---\n\n## 六个实用技能\n\nOpenSpec Extended 提供了六个实用技能，扩展了 AI 代理的能力：\n\n| 技能 | 用途 |\n|------|------|\n| `osx-concepts` | 教授 AI 代理 OpenSpec 框架的概念 |\n| `osx-modify-artifacts` | 修改工件并跟踪依赖关系 |\n| `osx-review-artifacts` | 审查工件的质量和完整性 |\n| `osx-generate-changelog` | 生成变更日志（遵循 Keep a Changelog 格式） |\n| `osx-review-test-compliance` | 审查 OpenSpec 变更的测试覆盖率 |\n| `osx-maintain-ai-docs` | 维护 AGENTS.md 和 CLAUDE.md |\n\n这些技能覆盖了软件开发的关键环节：从概念理解到工件修改，从质量审查到文档维护，形成了一个完整的工具链。\n\n---\n\n## 状态管理\n\nOpenSpec Extended 使用一套状态文件来跟踪变更进度：\n\n| 文件 | 用途 | 生命周期 |\n|------|------|----------|\n| `state.json` | 阶段跟踪 | 成功时删除 |\n| `complete.json` | 完成标记 | 验证后删除 |\n| `iterations.json` | 迭代历史 | 归档 |\n| `decision-log.json` | 代理推理 | 归档 |\n\n这些文件位于 `openspec/changes/<change>/` 目录下。阶段 6（归档）完成后，文件会被移动到 `openspec/changes/archive/YYYY-MM-DD-<change>/`，保留完整的历史记录。\n\n---\n\n## 使用方法\n\n### 安装\n\n```bash\n# 快速安装\ncurl -sSL https://raw.githubusercontent.com/amauryconstant/openspec-extended/main/install.sh | bash\n\n# 特定版本\nVERSION=v0.19.0 curl -sSL https://raw.githubusercontent.com/amauryconstant/openspec-extended/main/install.sh | bash\n```\n\n### 项目设置\n\n```bash\ncd your-project\n\n# 安装扩展资源\nopenspec-extended install opencode\n\n# 包含核心 OpenSpec 工作流（11 个命令）\nopenspec-extended install opencode --with-core\n```\n\n### 运行自主实现\n\n```bash\n# 基本用法\n.opencode/scripts/osx-orchestrate <change-name>\n\n# 带选项\n.opencode/scripts/osx-orchestrate add-auth --max-phase-iterations 20 --verbose\n.opencode/scripts/osx-orchestrate add-auth --from-phase PHASE3\n.opencode/scripts/osx-orchestrate add-auth --dry-run\n```\n\n### 可用选项\n\n| 选项 | 说明 |\n|------|------|\n| `--max-phase-iterations N` | 每阶段最大重试次数（默认：10，-1 表示无限） |\n| `--timeout N` | 超时秒数 |\n| `--model MODEL` | 指定使用的模型 |\n| `--verbose` | 启用详细输出 |\n| `--dry-run` | 显示将要执行的操作 |\n| `--force` | 强制操作 |\n| `--clean` | 开始前清理状态 |\n| `--from-phase PHASEX` | 从特定阶段开始 |\n\n---\n\n## 实际意义与启示\n\nOpenSpec Extended 代表了 AI 辅助软件开发的一个重要方向：**从协助到自主**。\n\n### 1. 渐进式自动化\n\n开发者可以根据任务复杂度选择工作模式：\n\n- **简单任务**：使用手动工作流，保持完全控制\n- **复杂任务**：使用自主工作流，让 AI 代理端到端完成\n- **混合模式**：从特定阶段开始自主实现，人工介入关键节点\n\n### 2. 可审计的 AI\n\n与完全黑盒的 AI 编码工具不同，OpenSpec Extended 保留了完整的决策日志和迭代历史。这意味着：\n\n- **问题追溯**：当出现问题时，可以查看代理的推理过程\n- **知识积累**：历史记录成为团队的宝贵资产\n- **合规支持**：满足需要审计追踪的行业要求\n\n### 3. 专业化代理分工\n\n三个专业代理的设计体现了软件工程的最佳实践。这种分工模式可以应用到其他 AI 系统中：\n\n- **分析型代理**：专注于理解和评估，不修改状态\n- **构建型代理**：拥有写权限，专注于实现\n- **维护型代理**：专注于保持系统健康\n\n### 4. 框架化思维\n\nOpenSpec Extended 展示了如何将 AI 能力"框架化"。通过定义明确的阶段、代理和技能，它将 AI 的不可预测性封装在可控的边界内，让团队可以安全地利用 AI 的能力。\n\n对于正在探索 AI 辅助开发的团队来说，OpenSpec Extended 提供了一个经过深思熟虑的参考实现，值得深入研究和借鉴。