网站建设七大步骤长沙市城市建设档案馆网站

网站建设七大步骤,长沙市城市建设档案馆网站,家居企业网站建设公司,工业产品设计就业前景一、为什么我们需要新的 AI 开发方式#xff1f; 很多开发者已经在用 ChatGPT、Claude 写代码了#xff0c;但普遍有三个痛点#xff1a; 上下文不稳定 每次提问都要重新解释项目结构、技术栈、规范。 生成结果不可控 AI 有时写得很好#xff0c;有时完全跑偏#xff0…一、为什么我们需要新的 AI 开发方式很多开发者已经在用 ChatGPT、Claude 写代码了但普遍有三个痛点上下文不稳定每次提问都要重新解释项目结构、技术栈、规范。生成结果不可控AI 有时写得很好有时完全跑偏风格、架构不统一。无法工程化只能“对话式写代码”难以融入 CI / 本地开发流程。这正是OpenSpec Claude CLI组合要解决的问题把 AI 从“聊天工具”升级为“受规范约束的开发工具”二、工具介绍OpenSpec 和 Claude CLI 是什么1.OpenSpec给 AI 的「工程说明书」OpenSpec本质上是一套结构化的工程规范描述方式用于告诉 AI项目是做什么的使用什么技术栈代码风格、架构约束安全、性能、边界规则你“允许 AI 做什么不允许做什么”你可以把它理解为AI 版本的《项目技术设计文档 编码规范》示例简化project: name: user-service language: Java framework: Spring Boot 3.x rules: - 禁止直接操作数据库必须通过 Repository - Controller 只做参数校验和转发 - 所有接口必须返回统一 ResultT2.Claude CLI真正进入你本地工程的 AIClaude CLI是 Anthropic 官方提供的命令行工具它的优势是可直接访问本地代码可结合 OpenSpec 使用适合“多文件、重构、理解项目”的任务比 Web 聊天更稳定、可复现三、OpenSpec Claude CLI 的协作模式整体流程如下OpenSpec规范 约束- Claude CLI理解规范在真实项目中执行开发任务一句话总结OpenSpec 决定“边界”Claude CLI 负责“执行”四、实战一步步搭建 OpenSpec Claude CLI 开发环境Step 1安装 Claude CLI前提已配置 Claude API Keynpm install -g anthropic-ai/claude-cli验证安装claude --versionStep 2在项目中创建 OpenSpec先决条件Node.js ≥20.19.0本地已有代码仓库Git 项目npm install -g fission-ai/openspeclatest验证是否成功openspec --versionStep 3让 Claude CLI 读取 OpenSpec在项目根目录执行进入你的项目目录cd your-project-directoryopenspec init初始化过程中OpenSpec 会做几件非常关键的事✅ 1. 绑定 AI 工具你会被提示选择当前使用的 AI例如Claude Code / Claude CLICursorGitHub Copilot偏弱这一步的意义OpenSpec 不是单独运行而是挂载在 AI 编程工具之上。✅ 2. 注入斜杠命令Slash Commands比如/openspec:proposal/openspec:apply/openspec:archive这些命令不是 shell 命令而是“给 AI 的工程级操作指令”✅ 3. 创建 OpenSpec 工作目录初始化后你会看到openspec/├── specs/ # 规范长期有效├── changes/ # 变更提案一次性└── archive/ # 已完成变更这一点非常重要OpenSpec 把「需求规范」和「实现变更」彻底分离了五、实战场景一新增一个业务接口Step 1起草变更提案Proposal当你有一个新需求时不是直接让 AI 写代码而是/openspec:proposal Add user list API这一步做的是把“模糊需求”变成“结构化变更”AI 会自动生成一个变更目录例如openspec/changes/add-user-list-api/├── proposal.md├── tasks.md└── spec.md每个文件的职责是proposal.md为什么要做这个变更解决什么问题tasks.md拆解为哪些实现步骤是否可以并行spec.md精确描述接口、参数、边界、场景关键点此时还没有写一行代码Step 2验证与审查像 Review 需求一样OpenSpec 把“需求 Review”变成了一个可执行动作。openspec list # 查看所有活跃变更openspec validate id # 校验规范完整性openspec show id # 查看变更详情这一步的工程意义是在写代码前把“错误需求”拦下来Step 3与 AI 迭代完善规范不是改代码例如你对 AI 说“给用户列表 API 增加分页和排序场景”AI 会只更新 spec.md不会碰实现代码不会偷偷“顺手写功能”这一步本质是把 AI 当成「需求分析师 架构助理」Step 4实施变更 Apply当你确认规范已经 OK/openspec:apply change这一步才是AI 开始写代码。但注意AI严格按照 tasks.md每个任务都有完成状态不允许“自由发挥”Step 5归档变更Archive当功能完成、测试通过/openspec:archive changeOpenSpec 会把变更移入 archive/将核心规范合并进 specs/标记该需求为“历史决策”这一步解决的是一个长期痛点为什么这个功能当初要这么设计