quick-ai: Instructions file for Claude Code

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（归档）	完成后保存变更记录