Agent Skills
返回列表
通用开发规范

通用开发规范

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8d820b1d/generic-dev-sop。

技能介绍

项目进入交付阶段时,流程比代码更稀缺

项目初期,多数团队都能靠临时约定推进开发。当功能数量增长、UI 与接口开始交叉、多人同时修改同一模块时,问题通常不是缺少实现能力,而是每次变更缺少同一组证据:需求是否被确认、契约是否更新、哪些部分属于 P0、验收条件是否真正通过、灰度与回滚是否做过演练。@user_8d820b1d/generic-dev-sop 针对这种协作漂移提供一套可执行的项目开发流程。

把项目推进和单功能交付拆成两层闭环

这套 SOP 的核心是两个循环。项目层按「底座 → 纵向切片 → 阶段门禁」推进,完成工程边界确认、技术栈确认、架构决策、任务计划、质量底座和开发记录;功能层则按「计划、契约、UI、实现、测试、证据」同步交付。每个任务都记录状态、职责边界和可判定的验收条件;状态只使用 未开始、分析中、设计确认、开发中、审查测试中、已完成、阻塞。它不要求先堆积页面,而是让 P0 的纵向切片真正可运行、可验证、可回写。

先冻结底座,再扩展业务能力

项目搭建阶段强调先确认独立目录、统一包管理器和锁文件,再把产品边界、固定技术栈、目录职责、数据模型、接口契约、安全基线和高风险验证写入 references/architecture.md。任务计划要求覆盖阶段估算、关键路径、功能矩阵和质量门禁,避免把所有工作写成「实现功能」这类无法验收的条目。开发记录会持续记录方案、进度和证据,而不是只在对话中口述结果。

证据与门禁一起进入迭代

单功能闭环要求先核对计划进度,再分析需求、设计最小方案、更新开发记录、准备 UI 静态稿和数据结构,然后开发并审查。无 UI 的后端或基础设施功能可以跳过视觉稿,但要在开发记录中说明原因。完成后需要回写总计划与功能矩阵;只有计划、契约、实现、测试和证据互相一致时,功能才进入交付。第四部分则在 P0 全绿后继续检查发布候选门禁、安全审查、真实环境验证、灰度指标、回滚演练和文档同步。

适用边界

它适合从零搭建并完整交付的新项目,也适合需要多角色协作和质量门禁的中大型项目。已有项目可以不重建底座,但仍应按单个功能的闭环推进;缺少计划时先补最小计划再编码。纯文案、无行为变化的单行修改、一次性脚本、Demo 或原型验证不必走完整 SOP。小型项目也可以采用轻量用法,跳过灰度、合规或回滚演练等门禁,但必须在 README 中记录跳过原因。

使用场景

  • 从零创建前后端项目,需要先确认技术栈、架构决策与统一目录骨架。
  • 已有中等规模仓库需要补充功能矩阵,并将新需求划入 P0/P1/P2。
  • 开发跨端客户端时要先验证平台差异、后台和权限等高风险能力。
  • 功能完成后需要归档开发记录、测试证据,并推进发布候选门禁。

适合人员

  • 负责新项目搭建的技术负责人,希望统一架构、计划和质量底座。
  • 中大型项目的后端或前端工程师,需要处理接口、数据模型和测试门禁。
  • 跨端客户端开发者,想先验证平台差异、后台与权限等高风险能力。
  • 需要管理功能优先级和验收证据的项目负责人或技术负责人。