Skip to content

CLAUDE.md

Latest commit

 

History

History
157 lines (111 loc) · 4.73 KB

CLAUDE.md

File metadata and controls

157 lines (111 loc) · 4.73 KB

CLAUDE.md - Quick AI 项目

VS Code 扩展项目，提供快速访问 Warp 终端、Claude CLI 和 Opencode CLI 的功能。

发布流程

发布前必须完成

  1. 更新 CHANGELOG.md

    • 每次发布新版本前，必须更新 CHANGELOG.md
    • 通过 git log --oneline 查看自上次发布以来的提交记录
    • 按照以下格式添加新版本的变更日志：
    ## [版本号] - YYYY-MM-DD

### Added / Changed / Fixed / Removed

- 变更描述

  2. 版本号管理

    • 在 package.json 中更新版本号
    • CHANGELOG.md 中的版本号与 package.json 保持一致
    • 在 CHANGELOG.md 底部添加版本对比链接

发布命令

# 1. 更新 package.json 版本号
# 2. 更新 CHANGELOG.md
# 3. 构建并发布
pnpm run deploy

OpenSpec 学习

以下内容用于学习 OpenSpec 理念。请 Claude 在协助时遵循渐进式引导原则。

项目背景

OpenSpec 是一种规范驱动的工作流方法，通过"先定义，后实现"的理念来提高软件开发的可预测性和质量。

核心理念

  1. Spec-Driven（规范驱动）: 所有的变更都从编写规范开始
  2. Artifact Workflow（制品工作流）: 通过一系列明确的制品（Proposal、Plan、Delta Spec 等）来推进变更
  3. Verification（验证）: 实现完成后进行验证，确保与规范一致

项目结构

openspec/
├── config.yaml       # OpenSpec 配置文件
├── specs/            # 主规范目录（存放系统级别的规范）
├── changes/          # 变更目录（存放进行中的变更）
│   └── archive/      # 已归档的变更

学习路径（渐进式）

第一阶段：理解概念（当前阶段）

你当前处于这个阶段，目标是理解 OpenSpec 的核心概念：

已了解的概念：

  • ✅ OpenSpec 是规范驱动的工作流
  • ✅ 项目使用 spec-driven schema

下一步学习：

  • 📝 理解 OpenSpec 的核心术语
  • 📝 了解制品工作流的具体步骤
  • 📝 掌握如何创建第一个变更

第二阶段：创建第一个变更

学习使用 OpenSpec 技能来创建和管理变更：

  • 使用 /opsx:new 或 /opsx:explore 开始探索
  • 创建 Proposal（提案）
  • 创建 Plan（计划）
  • 创建 Delta Spec（增量规范）

第三阶段：实施与验证

  • 使用 /opsx:apply 实施变更
  • 使用 /opsx:verify 验证实现
  • 使用 /opsx:archive 归档完成的变更

第四阶段：高级用法

  • 学习 /opsx:sync 同步规范
  • 批量归档变更
  • 自定义配置和规则

给 Claude 的指令

引导原则

  1. 渐进式学习: 不要一次性灌输所有概念，根据用户当前的学习阶段提供适量的信息
  2. 实践优先: 鼓励用户通过实际操作来学习，而不是只阅读理论
  3. 提问确认: 在进行下一步之前，确认用户已经理解当前概念
  4. 提供示例: 使用具体的示例来说明抽象概念

交互模式

当用户提出问题时：

  • 首先判断问题所属的学习阶段
  • 提供适合该阶段深度的解释
  • 询问是否需要更深入的说明或实践建议

当用户想要执行操作时：

  • 简要说明将要执行的操作及其目的
  • 执行操作后，解释结果和下一步选项
  • 询问用户是否理解或有其他问题

OpenSpec 核心术语速查

术语 说明
Change（变更） 一个功能、修复或改进的完整工作单元
Artifact（制品） 变更过程中产生的文档，如 Proposal、Plan、Spec
Proposal（提案） 描述"为什么"要做这个变更
Plan（计划） 描述"如何"实施这个变更的任务分解
Delta Spec（增量规范） 描述"做了什么"变更的详细规范
Spec（规范） 系统的完整规范文档
Archive（归档） 完成后保存变更记录

常用命令速查

命令 用途
/opsx:new 创建新变更
/opsx:explore 进入探索模式（思考、调研、澄清需求）
/opsx:continue 继续当前变更，创建下一个制品
/opsx:ff 快速创建所有制品
/opsx:apply 实施变更
/opsx:verify 验证实现
/opsx:archive 归档完成的变更
/opsx:sync 同步增量规范到主规范
/opsx:onboard 引导式入门教程

当前状态

学习阶段: 第一阶段（理解概念） 上次活动: 项目初始化 待完成任务:

  1. 理解 OpenSpec 的完整工作流
  2. 创建第一个测试变更
  3. 完成完整的变更周期

💡 提示: 这个文件会随着学习进度不断更新。每次完成一个阶段后，记得更新"当前状态"部分。