你不知道的AI编程：非工程师的Claude Code入门指南

curl -fsSL https://claude.ai/install.sh | bash

# 项目背景

面向运维团队的客户仪表盘。技术栈：Node.js + Next.js，
前端使用 React，PostgreSQL 数据库，部署在 Vercel 上。
PM 是 Alice，设计师是 Bob，后端是我。

# 工作规则

- 所有注释用英文，变量和函数名用英文。
- 在做出任何修改前说明意图，等待我的确认。
- 对于新功能，编写实现代码，除非我要求否则不添加测试。
- 数据库表名使用 snake_case，例如 user_profile。

# 禁止事项

- 不要主动重构我没有提到的文件。
- 除非我明确说明，否则不要删除任何文件。
- 未经确认不要为新的依赖项运行 npm install。

# 压缩时保留的内容

当长对话被自动压缩时，按以下优先级保留：
1. 架构决策及其背后的理由
2. 哪些文件被修改以及修改内容
3. 当前进度状态
4. 尚未完成的待办事项

用 Swift 给我构建一个原生 macOS 语音输入工具：

1. 按住 Fn 键开始录音，松开后将转录文本注入到当前聚焦的输入框中。优先使用流式转录（Apple Speech Recognition 框架）。通过 CGEvent tap 全局监听 Fn 键；阻止 Fn 事件传播，避免触发表情选择器。

2. 默认语言必须为简体中文（zh-CN）——开箱即用支持中文。菜单栏可切换为英文、繁体中文、日文、韩文；将选择持久化到 UserDefaults。

3. 录音时，在屏幕底部居中显示一个无边框胶囊状 HUD：无交通灯按钮，无标题栏。使用 NSPanel（nonactivatingPanel）+ NSVisualEffectView（.hudWindow 材质）。高度 56px，圆角半径 28px。左侧显示实时音频波形（5 根垂直条，由 RMS 电平驱动），右侧显示转录文本（弹性宽度 160-560px）。入场弹性动画 0.35s，文本宽度过渡 0.25s，退场缩放 0.22s。

4. 通过剪贴板 + 模拟 Cmd+V 注入文本。注入前，检测当前输入源：如果是 CJK 输入源，临时切换到 ABC，粘贴，然后恢复原输入源。之后恢复原始剪贴板内容。

5. 接入 LLM 以提高中英文混合识别的准确率。使用兼容 OpenAI 的 API（可配置 Base URL、Key、Model）来优化转录文本。系统提示词必须极其保守：只修正明显的语音识别错误（例如 "pie son" -> "Python"，"jay son" -> "JSON"），绝不重写或润色看起来正确的文本；如果看起来正确，原样返回。

6. 菜单栏提供一个 LLM 优化子菜单，包含启用/禁用开关和设置入口。设置窗口包含 API Base URL、API Key、Model 字段，以及测试和保存按钮。松开 Fn 后，如果 LLM 已启用，HUD 显示"优化中..."，直到收到响应后再注入。

7. 以 LSUIElement 运行（仅菜单栏图标，无 Dock 图标）。使用 Swift Package Manager 构建，附带 Makefile（build/run/install/clean）。

alias c='CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000 claude --dangerously-skip-permissions'

---
name: weekly-meeting-notes
description: 当原始会议记录需要整理时使用
---

## 输出格式

**本周完成**：[负责人] 完成了什么
**下周计划**：[负责人] 做什么，截止日期
**待解决问题**：卡在什么上，需要谁的决策
**行动项**：[谁] [做什么] [截止日期]

## 规则

- 不要润色，保留原始措辞
- 缺失信息标记为“需要确认”，不要猜测

---
name: launch-checklist
description: 在发布功能前运行，确认没有遗漏
---

## 发布前必须全部通过

- [ ] PRD 中的每个验收标准已确认
- [ ] 设计与实现一致：间距、文案、交互
- [ ] 边界状态（空状态、错误、超时）均已处理
- [ ] 按规范埋点分析事件
- [ ] 在预发布环境验证

## 输出

每个项目标记为通过/失败。任何失败项必须在发布前修复。

---
name: incident-triage
description: 当告警触发或用户报告故障时使用
---

## 收集信息

- 错误截图或完整错误日志
- 影响范围：哪些用户、哪个页面、何时开始
- 近期变更：代码发布、配置修改、数据变更

## 诊断矩阵

| 症状       | 优先检查项                     |
| 白屏       | JS 错误 → 近期发布             |
| API 超时   | 服务监控 → 慢查询              |
| 数据异常   | 近期数据变更 → 上游数据源      |

## 输出格式

根本原因 / 影响范围 / 修复步骤 / 验证方式