核心用法
Code Skill 是一套结构化的软件开发辅助工作流，专注于规划、实现、验证、交付四个阶段的编码指导。它通过 planning.md 提供任务分解模式，借助 execution.md 规范执行流程，并利用 verification.md 建立测试验证标准。用户可在 ~/code/memory.md 中存储个人编码偏好（如"记住我喜欢 X"），Skill 会在后续交互中优先读取这些偏好。
显著优点
1. 安全优先设计：明确禁止自动执行代码、网络请求、访问项目外文件或自主修改自身文件，所有子代理委派均需用户显式授权
2. 用户控制权：提供 GUIDANCE 而非自主执行，每个阶段推进由用户决定，避免"黑盒式"开发
3. 质量保障机制：强制验证环节——每个函数后建议测试、UI 变更后建议截图、交付前建议完整测试套件
4. 模块化规划：将需求拆分为独立可验证的步骤，避免巨型 PR，支持多任务状态管理 (state.md)
5. 零数据外泄：完全本地运行，无网络端点，仅存储用户显式要求的偏好数据
局限性与风险
- 非自动化工具：不提供代码自动补全、实时错误检测或 IDE 集成，需用户手动触发各阶段
- 依赖用户主动性：偏好记忆需用户明确说"记住/永远不要"，系统不会主动学习习惯
- 验证建议非强制：测试建议需用户自行执行，Skill 本身不运行测试框架
- 无代码生成能力：仅提供工作流指导，不直接产出代码实现
适合人群
- 需要结构化开发流程的独立开发者
- 重视代码质量与测试覆盖率的团队
- 对 AI 自主操作有安全顾虑、偏好逐步确认的用户
- 多平台开发者（支持 Linux/macOS/Windows）
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 偏好误存储 | 可能记录非预期的用户随口表述 | 仅响应明确的"记住/永远不要"指令 |
| 验证跳过 | 用户可能忽略测试建议直接交付 | 流程设计中反复嵌入验证提醒 |
| 目录权限 | `~/code/` 创建需文件系统权限 | 首次使用时自动 `mkdir -p` |
| 跨项目污染 | 记忆文件可能残留过时偏好 | 建议定期人工清理 `memory.md` |
技术架构
采用纯本地文件系统架构，核心文件矩阵包括：规划模板、执行流、验证清单、状态跟踪、用户标准。通过严格的 Scope 声明（ONLY/NEVER 清单）实现最小权限原则，版本 1.0.4 优化了描述清晰度。