提供结构化编码工作流:规划→执行→验证→交付,支持偏好记忆但绝不自动执行代码,强调用户控制与测试验证
说明:
## 核心用法
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 优化了描述清晰度。









