OpenSpec-practise

基本信息

• 仓库地址：https://github.com/ForceInjection/OpenSpec-practise
• 维护者：ForceInjection
• 形式：个人实践仓库 + 中文手册
• 收录日期：2026-07-13

仓库定位

围绕 OpenSpec 的规格驱动开发流程整理中文实践材料：手册、实践指南与协作命令。它与 vibe-coding-cn（中文 Vibe Coding 工作流仓库）、claude-code-orange-book（Claude Code 橙皮书仓库）、learn-claude-code（从最小循环到完整 Harness 的中文教学仓库） 一同构成 wiki 中 AI 辅助开发的不同路径——Vibe Coding 系列强调自然语言入口的速度，OpenSpec-practise 强调把需求与决策本身外化为可审查文档。

内容结构

仓库的基本流程把一次变更拆成多层文档：

• proposal：描述为什么要做这次变更以及范围。
• spec：写入用户场景、行为与验收条件。
• design：对复杂架构选择补充关键技术决策。
• tasks：把实现拆成可逐项推进的清单。
• archive：变更完成后归档决策和实施历史。

文档目录本身就是工作状态，使 Agent 在不同会话中能找回当前要做的事和历史决策。

适用对象

• 跨文件功能、需多文件协调的实现。
• 多人协作、需长期维护的项目。
• 容易被 Agent 误解或上下文较复杂的任务。
• 不适合一次性脚本或极小改动。

配合使用的工具

• OpenSpec：规格驱动开发框架。
• Claude Code、tools/Codex-CLI 等 coding agent：依据规格文档推进开发。
• Git：作为版本控制与变更归档底座。

与 wiki 既有内容的互补关系

• 与 vibe-coding-cn（中文 Vibe Coding 工作流仓库） 互补：vibe-coding-cn 强调自然语言驱动，OpenSpec-practise 强调结构化文档约束。
• 与 CLAUDE.md 项目级指令文件（Claude Code 项目宪法）、methods/method-project-agents-md-instruction-file 互补：CLAUDE.md / AGENTS.md 是"项目级指令"，OpenSpec 是"变更级指令 + 变更级验收"。
• 与 methods/method-plan-first-before-implementation 方向一致但更深一层：HaiJun 的方法强调先有实施计划，OpenSpec 把计划扩展为 proposal / spec / design / tasks 多层体系。

边界与说明

• 仓库未对所有样例进行独立部署或性能测试。
• 具体命令和目录结构可能随上游版本变化，以收录时仓库版本为准（观察日期 2026-07-13）。