核心用法
Code 是一套面向软件开发的工作流指导技能,而非自动编码工具。其核心模式为 Plan → Execute → Verify → Deliver,强调在每个阶段都保持用户主导权。
关键特性:
- 记忆系统:在
~/code/memory.md中存储用户显式声明的偏好(如"记住我用 2 空格缩进"),首次使用自动创建目录 - 规划优先:强制要求将需求拆分为可独立验证的测试步骤,避免巨型 PR
- 验证驱动:每个函数后建议运行测试、UI 变更后建议截图、交付前建议完整测试套件
- 用户控制:所有执行需用户确认,子代理委派需显式请求,绝不自动执行代码或网络请求
显著优点
1. 安全边界清晰:文件访问严格限制在 ~/code/ 和用户项目内,零网络请求,零自动执行
2. 可审计的工作流:内置 planning.md、verification.md 等参考文档,确保过程透明
3. 渐进式交付:通过状态管理(state.md)支持多任务中断恢复
4. 隐私友好:仅存储用户主动要求保存的数据,无遥测或云端同步
潜在局限
- 非自动化工具:不提供代码补全、实时建议或一键生成功能,重度依赖用户主动性
- 学习曲线:需理解其规划-验证方法论,对习惯快速迭代的开发者可能感觉"繁琐"
- 无 IDE 集成:作为独立工作流指导,不直接集成 VS Code 等编辑器
- 子代理限制:代码生成/调试需用户显式请求委派,无法自动调用外部工具
适合人群
- 追求代码可维护性的中高级开发者
- 需要结构化代码审查流程的团队
- 对自动执行有安全顾虑的隐私敏感用户
- 学习软件工程最佳实践的初学者(需配合耐心)
常规风险
| 风险点 | 说明 |
|--------|------|
| 过度规划 | 简单任务可能因强制规划步骤而效率降低 |
| 人为疏漏 | 验证步骤仅作"建议",用户跳过可能导致交付未经测试的代码 |
| 记忆文件管理 | 长期未清理的 `memory.md` 可能积累过时偏好,需定期维护 |
| 期望错位 | 误以为是 AI Copilot 类自动编码工具的用户可能失望 |
版本信息
- v1.0.4 | 优化描述以提升可发现性 | 主页