# pro-skills **Repository Path**: snail_tech/pro-skills ## Basic Information - **Project Name**: pro-skills - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-04 - **Last Updated**: 2026-07-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # pro-skills > **项目全流程开发技能（project-fullcycle）+ 配套脚手架** — 从需求到交付的完整生命周期管控与质量保证。 ## 项目定位 `pro-skills` 是一个 **AI 编码辅助技能框架**，旨在让 AI 在项目开发的任何阶段都能： 1. **按标准化流程执行** — 不跳阶段、不自由发挥 2. **有量化产物输出** — 不"差不多就行" 3. **有可验证的质量保证** — 不留隐患到后期 4. **支持多编辑器** — CodeBuddy / Claude Code / Trae / Qoder ## 核心特性 ### 一条流水线，九个阶段 | # | 阶段 | 子 skill | 核心产出 | 门禁 | |---|------|---------|---------|------| | 1 | **需求** | `skills/01-需求评估/` | 需求大纲、用户故事 | ≥ 85 | | 2 | **调研** | `skills/02-技术调研/` | 技术选型、最小依赖 | ≥ 85 | | 3 | **设计** | `skills/03-全局设计/` | 7 大维度 + 4 类流程化产物 | ≥ 85 | | 4 | **原型** | `skills/04-原型设计/` | 页面清单、流转图、接口预演 | ≥ 85 | | 5 | **架构** | `skills/05-架构设计/` | 模块分层 + 4 类联调产物 | ≥ 85 | | 6 | **实现验证** | `skills/06-实现验证/` | 开发+测试融合(共一门禁) + 02H 验收 + 02I 联调 | ≥ 90 | | 7 | **验收交付**（事后按需）| `skills/07-验收交付/` | 4 维 UX 终验、交付清单 | ≥ 95 | | 8 | **迭代规划**（事后按需）| `skills/08-迭代规划/` | 复盘、规划、模块化能力升级 | — | ### 四层防护体系 | 层级 | 机制 | 位置 | |------|------|------| | **L1** | 7 条全局硬约束（always-on）| `GLOBAL.md § 0.5` | | **L2** | 9+ 场景自动加载映射 | `GLOBAL.md § 0.5` | | **L3** | 21 个 @constraint-block 嵌入章节 | 各 chapter 顶部 | | **L4** | 任务 checklist（3-A 5 类）| `GLOBAL.md § 3-A.1` | | **L5** | 20+ 条跑偏修正话术 | `GLOBAL.md § 3-A.3` | | **L6** | 强制记忆归档 | `.codebuddy/memory/` | ### 三段式质量闭环 ``` 事前（设计） 事中（执行） 事后（验证） ↓ ↓ ↓ 4 类流程化产物 联调 4 步 + 7 状态机 8 项验证清单 + 4 类联调产物 + 8 条铁律 + 真实场景 ≥ 80% + 02H 12 项验收 + 4 级阻塞升级 + 回归测试 + bug 修复纪律 ``` ### 模块化能力 6 属性 每个产物（模块/脚本/工具/设计文档）必须满足： 1. **边界清晰** — 对外只暴露有限入口 2. **能力自描述** — 必附 7 要素能力声明卡片 3. **依赖单向** — 不串联、不依赖实现 4. **可独立验证** — Mock 替换下可单独跑通 5. **可独立替换** — DI/工厂/接口抽象 6. **分层清晰** — L1 基础 / L2 融合 / L3 应用 ## 目录结构 ``` pro-skills/ ├── GLOBAL.md # 极简引子（≤500 行，AI 编辑器始终注入） ├── SKILL.md # 总入口（编排器） ├── SKILL-SUMMARY.md # 完整技能体系总结（全景视图） │ ├── skills/ # 11 个子 skill（双层加载：全局 3 + 阶段 6 + 事后按需 2；共 104 文件 / ~13,200 行） │ ├── 00-核心原则/ # 核心原则 │ ├── 01-需求评估/ # 需求拆解 │ ├── 02-技术调研/ # 技术调研 │ ├── 03-全局设计/ # 全局设计（含 4 类流程化产物） │ ├── 04-原型设计/ # 原型设计 │ ├── 05-架构设计/ # 架构设计（含 4 类联调产物） │ ├── 06-实现验证/ # 实现验证（开发+测试融合，37 章节；含 02H/02I/T-系列） │ ├── 07-验收交付/ # 验收与交付 │ ├── 08-迭代规划/ # 迭代规划 │ ├── 11-防跑偏/ # 防跑偏机制（含 17/18 跑偏检查） │ ├── skills/12-模块化设计/SKILL.md # 模块化设计最高纲领 │ ├── 12-模块化设计/ # 全局层·模块化最高纲领（12 章） │ └── 13-约束模板/SKILL.md # 约束块模板 │ ├── scaffolds/ # 配套脚手架（17 文件） │ ├── .ci/ # CI 配置 │ ├── docs/ # 架构文档模板 │ ├── project-root/ # 项目根模板（.editorconfig/.gitignore） │ ├── shared/ # 共享资源 │ ├── templates/ # 契约/Schema/模块定义模板 │ └── tools/ # 5 个检查脚本（模块/依赖/Mock/三层） │ └── .codebuddy/ # IDE 配置 + 工作记忆 └── memory/ # 跨会话长期记忆 ``` ## 快速开始 ### 1. 适用场景 适用于任何需要 **AI 辅助高质量全流程交付** 的软件项目： - 中小团队首选 - 模块化单体架构 - 需要标准化流程与质量保证 ### 2. 多编辑器集成 将 `GLOBAL.md` 放入 AI 编辑器的全局规则/系统提示中。 | 编辑器 | 配置位置 | 状态 | |--------|---------|------| | CodeBuddy | `项目/.codebuddy/rules/project-fullcycle.md` | ✅ 已支持 | | Claude Code | `项目/CLAUDE.md` | ✅ 已支持 | | Trae | `项目/.trae/rules/project-fullcycle.md` | ✅ 已支持 | | Qoder | `项目/.qoder/rules/project-fullcycle.md` | ✅ 已支持 | 详见 [skills/11-防跑偏/SKILL.md](./skills/11-防跑偏/SKILL.md) 多编辑器适配部分。 ### 3. 加载流程 ``` AI 启动 → 识别任务类型 ↓ 从 GLOBAL.md 加载 7 条全局硬约束（始终生效） ↓ 按自动加载映射表 → 加载对应章节（按需） ↓ 加载章节时 → 解析 @constraint-block → 激活约束 ↓ 执行任务（按章节内容） ↓ 违反约束 → @violation_response 标准话术 ↓ 任务结束 → 全局硬约束自检（7 条） ↓ 通过 → 交付；不通过 → 修正 ``` ### 4. 关键纪律 | 纪律 | 章节 | 红线 | |------|------|------| | **按分层顺序一次只实现一个模块** | [06-02D](./skills/06-实现验证/chapters/07-按分层一次一模块.md) | ≤ 500 行/次，≤ 10 方法/次 | | **跨模块依赖跳转** | [06-02E](./skills/06-实现验证/chapters/08-跨模块依赖跳转.md) | 4 步纪律 + jump-state.json | | **真实使用场景测试** | [06-02F](./skills/06-实现验证/chapters/10-真实使用场景测试.md) | Mock ≠ 真实可用 | | **bug 修复纪律** | [06-02G](./skills/06-实现验证/chapters/09-bug修复纪律.md) | 暂停+状态+恢复 | | **设计产物验收** | [06-02H](./skills/06-实现验证/chapters/11-设计产物逐项验收.md) | 12 项 checklist 100% | | **联调执行纪律** | [06-02I](./skills/06-实现验证/chapters/12-事中联调执行纪律.md) | 4 步+7 状态机+8 铁律 | | **设计期流程化产物** | [03-08](./skills/03-全局设计/chapters/01-设计期流程化产物.md) | 4 类产物+10 项红线 | | **前后端联调设计** | [05-15](./skills/05-架构设计/chapters/15-前后端联调设计规范.md) | 4 类联调产物+10 项红线 | | **事后验证收口** | [07-09](./skills/06-实现验证/chapters/20-事后验证三段式收口.md) | 8 项验证清单 | | **设计期跑偏检查** | [11-17](./skills/11-防跑偏/chapters/17-设计期流程化产物缺失跑偏检查.md) | 7 类跑偏+话术 | | **三段式跑偏检查** | [11-18](./skills/11-防跑偏/chapters/18-三段式与联调跑偏检查.md) | 6 类跑偏+话术 | ## 项目统计 | 指标 | 数值 | |------|------| | **子 skill 数** | 12 | | **markdown 文件** | 117 | | **代码总行数** | ~15,400 | | **拆解后 chapter** | 90+ | | **@constraint-block** | 21 | | **全局硬约束** | 7 条 | | **跑偏修正话术** | 20+ 条 | | **commit 数** | 22 | ## 详细文档 | 文档 | 用途 | |------|------| | [SKILL.md](./SKILL.md) | 总入口（515 行），含架构/9 阶段/9 铁律速查 | | [SKILL-SUMMARY.md](./SKILL-SUMMARY.md) | 完整技能体系全景式总结（506 行） | | [GLOBAL.md](./GLOBAL.md) | 极简引子（500 行），含 7 条硬约束 + 自动加载映射 + 任务 checklist | | [skills/12-模块化设计/SKILL.md](./skills/12-模块化设计/SKILL.md) | 模块化设计最高纲领（565 行） | ## 核心设计哲学 > **把大项目拆为小模块，每个小模块只做一件事、做好这件事、说清楚自己能提供什么能力；小模块之间通过接口协作，不互相窥探实现。** - **大→小（拆）** — 按业务域/能力域拆为多个小模块 - **小→精（做）** — 边界清晰、能力自描述、可独立验证、可独立替换 - **小↔小（合）** — 通过标准化接口协作，不串联、不双向依赖 ## 验证 - ✅ 单文件 ≤ 500 行（拆分原则） - ✅ 单方法 ≤ 100 行（[06-01](./skills/06-实现验证/chapters/02-代码规模与编码约束.md)） - ✅ 联调通过率 ≥ 90%（[07-09](./skills/06-实现验证/chapters/20-事后验证三段式收口.md)） - ✅ 真实场景覆盖 ≥ 80%（[07-09](./skills/06-实现验证/chapters/20-事后验证三段式收口.md)） - ✅ 性能用例 100% 达标（[07-09](./skills/06-实现验证/chapters/20-事后验证三段式收口.md)） - ✅ 8 阶段门禁 85/90/95（需求/调研/设计/架构≥85，原型/开发+测试≥90，验收≥95） ## 待办项 - [ ] **04-原型设计 拆分**：687 行超 500，应按章节拆为子文件 - [ ] **真实项目试点**：本技能经过 14 轮抽象，但**尚未在真实项目完整跑过 0→交付**（需选 1 个项目做完整试点） - [ ] **多编辑器适配验证**：需在 CodeBuddy / Claude Code / Trae / Qoder 各跑一遍 - [ ] **引用路径更新**：平移后 chapter 内部相对引用需更新 ## 贡献 1. Fork 本仓库 2. 新建 `Feat_xxx` 或 `Refactor_xxx` 分支 3. 提交代码（遵循项目纪律：单文件 ≤ 500 行、模块化能力 6 属性、阶段门禁） 4. 新建 Pull Request ## 许可证 MIT