工具与技能参考

一、Claude Code 核心能力

文件操作

操作 工具 说明
读取文件 Read 读取任何文件，支持图片、PDF、Jupyter
编辑文件 Edit 精确字符串替换，保持缩进
创建文件 Write 创建新文件（优先编辑已有文件）
搜索文件 Glob 按文件名模式搜索（如 **/*.swift）
搜索内容 Grep 按内容搜索（支持正则）
终端命令 Bash git、npm、docker、系统命令

关键原则

二、可用 Skills（Slash Commands）

项目管理类

Skill 用途 何时使用
/commit 创建 git commit 完成功能后提交
/code-review 代码审查 PR 提交前审查代码质量

开发类

Skill 用途 何时使用
superpowers:brainstorming 头脑风暴 创建功能前探索用户意图和设计
superpowers:writing-plans 编写实施计划 有需求规格时，编码前先计划
superpowers:test-driven-development 测试驱动开发 实现功能前先写测试
superpowers:systematic-debugging 系统性调试 遇到 bug 时，在提出修复前
superpowers:verification-before-completion 完成前验证 声称工作完成前，运行验证
document-skills:frontend-design 创建前端界面 需要设计 HTML/CSS/React 组件时

文档类

Skill 用途 何时使用
document-skills:docx 创建/编辑 Word 文档 需要专业文档输出时
document-skills:pdf 创建/处理 PDF 需要 PDF 输出时
document-skills:pptx 创建演示文稿 需要制作幻灯片时
document-skills:xlsx 创建/分析电子表格 数据分析和电子表格操作时

工作流类

Skill 用途 何时使用
superpowers:dispatching-parallel-agents 并行任务调度 2+ 个独立任务可以同时执行
superpowers:subagent-driven-development 子代理驱动开发 执行有独立任务的实施计划
superpowers:executing-plans 执行计划 有写好的实施计划需要执行
superpowers:requesting-code-review 请求代码审查 完成任务或重大功能后
superpowers:finishing-a-development-branch 完成开发分支 实施完成，准备集成

三、Agent 类型

可用代理

代理 用途
Explore 快速探索代码库，搜索文件/关键词
Plan 设计实施计划，分析架构权衡
Bash 执行 shell 命令
general-purpose 通用研究和多步任务
code-simplifier 简化和重构代码
code-reviewer 审查已完成的代码是否符合计划

使用策略

四、Kept 项目专用工具链

iOS 开发

工具 用途
Xcode 项目构建、模拟器运行、真机部署
SwiftUI Preview 快速预览 UI 变更
Instruments 性能分析（内存、CPU、网络）
Core Data Model Editor 数据模型设计

云端开发

工具 用途
Node.js + npm API 开发和依赖管理
curl / httpie API 端点测试
Anthropic SDK Claude API 调用
pm2 / systemd 生产环境进程管理

调试与测试

工具 用途 优先级
Xcode Debugger Swift 断点调试 必备
Console.app 查看系统日志（通知、位置） 必备
XCTest iOS 单元测试 必备
jest / vitest Node.js 测试 必备
Charles / Proxyman 网络请求抓包 按需

模拟器位置测试

Xcode 模拟器支持自定义位置，用于 D4 地理围栏调试：

五、MCP 服务器工具

Context7 文档查询

常用库名参考

搜索关键词 用途
apple swiftui SwiftUI 视图、动画、手势
apple core location 地理围栏、位置服务
apple widgetkit 锁屏/桌面 Widget
apple speech 语音识别 SFSpeechRecognizer
apple app intents Action Button / Shortcuts
anthropic sdk Claude API Node.js SDK
expressjs Express 路由、中间件

使用流程

  1. 先 resolve-library-id 找到正确的库 ID
  2. 再 query-docs 查询具体问题
  3. 每个问题最多调用 3 次

六、Git 工作流

分支策略

main                              ← 稳定版本，每天验收通过后合并
├── feat/speech-service           ← D1 语音服务
├── feat/cloud-api                ← D2 云端 API
├── feat/end-to-end               ← D3 端云串联
├── feat/notifications            ← D4 提醒系统
├── feat/widget                   ← D5 Widget
└── feat/polish                   ← D6 打磨

MVP 阶段只有一个开发者，省略 dev 中间分支。feat/* 验收通过后直接合入 main。

提交规范

feat: 添加语音录入功能
fix: 修复地理围栏不触发的问题
refactor: 重构 MemoryStore 数据访问层
docs: 更新开发文档
test: 添加 LLM JSON 解析测试

安全规则