OpenSpec

工具定位

OpenSpec 是 ForceInjection 在 OpenSpec-practise 仓库中介绍的规格驱动开发框架。它把一次开发变更拆成 proposal、spec、design、tasks 等结构化文档，让 AI 助手（典型如 Claude Code、tools/Codex-CLI）按文件推进开发，而不是从一句模糊需求直接改代码。

观察日期：2026-07-13。具体命令与目录结构以收录时仓库版本为准。

核心约定

• proposal：变更的原因与范围。
• spec：用户场景、行为和验收条件。
• design：复杂架构选择与关键技术决策。
• tasks：可逐项推进的实现清单。
• archive：完成后的决策与实施历史归档。

适合配合的 agent 与工作流

• 在 CLAUDE.md 项目级指令文件（Claude Code 项目宪法）（CLAUDE.md 项目宪法）之上叠加"变更级"规格，作为每次改动的可审查上下文。
• 与 methods/method-plan-first-before-implementation 的精神一致，但 plan 被进一步拆分为多层文档。
• 与 Claude Code 计划模式工作流（Plan Mode） 互补：Plan Mode 输出当前任务计划，OpenSpec 保留跨会话、可追溯的决策记录。

适用任务

• 把模糊需求整理成可验收的规格：把模糊需求整理为可验收规格。
• 让 coding agent 按任务清单逐项推进：让 coding agent 按任务清单逐项推进。
• 为 AI 开发项目保留决策与实施历史：为 AI 开发项目保留决策与实施历史。

限制与风险

• 规格驱动开发中规格错误被稳定放大的风险：规格本身写错，AI 会更稳定地实现错误目标。
• 增加前期文档成本，不适合一次性脚本。
• 文档维护本身需要持续投入。
• 具体命令和目录结构可能随上游版本变化，使用前应核对仓库最新版本。