Skip to content
Back to search

cainiao-dev-ape

SkillWorks with Claude CodeGitHub

一个人带多个 AI 做软件项目的通用开发流程。从需求问卷、产品功能说明书、任务拆分、效果图、风格冻结,到方案评审、代码构建、独立验收、发版,每一步谁做、做到什么算过都写死。带 6 个零依赖工具(调试台含网格量尺、S-1 勾选器、S4 冻结、门禁矩阵、任务书生成、问卷转说明书),以及方案图证据纪律与一页讲清模板、UI 交付六铁律与验收三查(v4.64)。触发词:立项 / 开工 / 走开发流程 / 方案图 / 做界面 / 验收自查。旧名 dev-workflow-1n1n 保留为检索别名。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/b29-ctrl--cainiao-dev-ape/badge.svg)](/listings/b29-ctrl--cainiao-dev-ape)

HTML

<a href="/listings/b29-ctrl--cainiao-dev-ape"><img src="/api/listings/b29-ctrl--cainiao-dev-ape/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 367 lines
  1. ---
  2. name: cainiao-dev-ape
  3. display-name: 菜鸟开发猿
  4. version: 4.64.0
  5. description: 一个人带多个 AI 做软件项目的通用开发流程。从需求问卷、产品功能说明书、任务拆分、效果图、风格冻结,到方案评审、代码构建、独立验收、发版,每一步谁做、做到什么算过都写死。带 6 个零依赖工具(调试台含网格量尺、S-1 勾选器、S4 冻结、门禁矩阵、任务书生成、问卷转说明书),以及方案图证据纪律与一页讲清模板、UI 交付六铁律与验收三查(v4.64)。触发词:立项 / 开工 / 走开发流程 / 方案图 / 做界面 / 验收自查。旧名 dev-workflow-1n1n 保留为检索别名。
  6. author: b29-ctrl
  7. tags: dev-workflow, project-management, multi-agent, requirements, product-spec, quality-gate, ui-mockup, architecture-diagram, explainer
  8. category: development
  9. ---
  10. # 菜鸟开发猿 · 1 主理人 + N 小组队长 + N AI 通用开发流程
  11. > **一句话**:一个人带一群 AI 也能把项目做完、做对、做不返工——因为**决策头永远 1 个,执行可以无限加,且人多不会打架**。
  12. **版本**:v4.64 | **体积**:约 567 KB(含本版改动说明;不含备份)| 纯文本 + 单文件工具,零依赖 | Windows / macOS / Linux
  13. **SKILL.md 本体**:约 19.5 KB(以文件实际为准;上面的「约 567 KB」指整包体积)。
  14. **更名**:自 v4.61 起,本技能统一更名为「菜鸟开发猿」(原名 `dev-workflow-1n1n`,旧名保留为检索/兼容别名)。
  15. **交付说明**:本包为可交付版——开发残留已清、版本号统一、个人路径已移除;授权/商用/回传口径见 `交付须知.md`。流程本体文件名沿用历史版本号(`20261107_通用开发流程_v4.45.md`),内容随包更新至当前版本,别以文件名判断版本。
  16. **跨平台提示**:非 Windows 把 `python` 换成 `python3`;Windows 管道下中文乱码时先设 `PYTHONUTF8=1`;流程中的截图命令(`shot.py`)属可选外部件,未随包提供,可用任意截图工具替代。
  17. ---
  18. ## 激活技能:说一个触发词
  19. 装好之后,不用记命令,**说下面任一个词就激活**:
  20. | 说这个 | AI 会 |
  21. |---|---|
  22. | **立项** | 启动流程,立刻做 S-1 四问 |
  23. | **开工** | 同上 |
  24. | **走开发流程** / **用开发流程做** | 同上 |
  25. | **接入调度台** / **交给调度台** | 进入 S4.5,把 S4 冻结结果交接到工单调度台 |
  26. | **派单** | S4.5 后按调度台流程建 S5 工单/派单 |
  27. | **做界面** / **出效果稿** / **验收自查** | 读 `06_UI交付与验收.md`,按六条铁律做、交付前三查(v4.64) |
  28. ### 需求定位方式:问卷 / 深访(v4.51 仅登记写法)
  29. > 默认:S0.1 需求问卷生成法(`01_流程` §十六)不变,一次给全量题目,最快把「要什么」定位清楚;
  30. > 深访:仅在高风险 / 需求模糊 / 老板点名时启用,一次一问把决策逐条定下,避免方案阶段返工。
  31. > 写法登记:本批仅登记「拷问我 / 盘问方案 / grill」三个说法,它们到 **v4.60** 才生效;现在说了不会进入深访模式,也不新增任何命令、不改上方触发词表。
  32. > 深访的具体形态与工具实现在 v4.60,本批只写文档,不改变现有流程形态。
  33. **激活后 AI 的第一句话应该是**:
  34. > 收到,启动开发流程。先做 S-1 环境初始化——
  35. > ① 你用什么模型?② 有几个 AI?③ 我按数量给你分配角色,你确认 ④ 项目目录在哪?
  36. 如果不是这句,说明它没读到 `给AI的启动指令.md`,把那份文件发给它。
  37. ### 四问不用打字:双击 `S-1_环境初始化.html`
  38. 包里带了一个勾选器,**勾一勾就生成 `00_环境.md`**:
  39. | 步骤 | 做什么 |
  40. |---|---|
  41. | ① 选模型 | 点 PRO / 普通 |
  42. | ② 选 AI 数量 | 点 3–12,角色表自动变 |
  43. | ③ 填 AI 名字 | 每个席位填一个名字,**同人兼写码+审会被红字拦住**;也可点「上传 AI 岗位配置」读 `ai-roster/v1` 自动预填 |
  44. | ④ 填目录 | 粘盘符路径 |
  45. | ⑤ 生成 | 点「生成 00_环境.md」→ 复制 → 粘进项目目录 |
  46. > S-1 生成的 `00_环境.md` 放进项目目录后,接入调度台的项目会在每次群聊/派单时自动把它作为“项目固定背景”注入给 AI(可在项目里关闭)。AI 收到任务先据此自检,不要重复向用户要背景。
  47. ### 其它常用指令
  48. | 说这个 | 效果 |
  49. |---|---|
  50. | **流程到哪了** / **进度** | 报当前阶段 + 下一步 + 还差什么 |
  51. | **暂停流程** / **不用流程了** | 退出流程模式,回普通对话 |
  52. | **只要工具** | 跳过流程,只用调试台改界面 |
  53. | **重新开一个项目** | 归档当前 `00_环境.md`,重新 S-1 |
  54. ### 给 AI 的安装说明
  55. 如果你是把包交给另一个 AI(不是你自用),**第一句话发这个**:
  56. ```
  57. 装好了吗?从现在起按这个包的流程走。
  58. 先读「给AI的启动指令.md」,然后对我做 S-1 四问。
  59. 以后我说"立项"就进流程,说"暂停流程"就退出。
  60. ```
  61. ---
  62. ## 骨架:三层可伸缩
  63. ```
  64. 唯一主理人(人) 1 个,永远不拆不加 ← 定方向、终验、发版、裁决冲突
  65. ├─ 小组队长 0 … N(人) ← 各管一摊需求确认,按板块加
  66. └─ AI 3 … N ← 写码 / 构建 / 审 / 验收,按依赖图加
  67. ```
  68. | 层 | 数量 | 能不能增 |
  69. |---|---|---|
  70. | 主理人 | **1** | ❌ 不拆、不加 |
  71. | 小组队长 | **0 … N** | ✅ 按板块加(项目小可以一个都不要) |
  72. | AI | **3 … N** | ✅ 下限 3,上限按依赖图 |
  73. | 项目规模 | 主理人 | 小组队长 | AI |
  74. |---|---|---|---|
  75. | 小(单页工具) | 1 | 0 | 3 |
  76. | 中(进销存 9 板块) | 1 | 1 | 6 |
  77. | 大(一卡通 12 板块) | 1 | 2 | 9 |
  78. **人不够就加小组队长,不是加主理人**——N 个平级主理人的冲突面是 n(n-1)/2,一个项目会被拍散。
  79. ---
  80. ## 3 分钟上手
  81. ### 第 1 步:准备(一次性)
  82. ```bash
  83. python -V # 3.9 以上即可,不用装任何库
  84. # macOS / Linux 用 python3 -V
  85. ```
  86. ### 第 2 步:建项目目录
  87. ```
  88. 你的项目/
  89. ├── index.html ← 空白页也行
  90. └── 00_环境.md ← 从 03_模板/00_环境.md 复制过来
  91. ```
  92. > **00_环境.md 必须在项目目录里**:启动器和调试台都只读这个文件来判断"风格选了没"。
  93. > 没有它,每次启动都会重复弹选型页,顶栏永远显示"风格:未选择"。
  94. ### 第 3 步:启动
  95. ```bash
  96. python 02_工具/启动项目.py --dir "你的项目目录" --port 8792
  97. ```
  98. 会看到两件事:
  99. 1. 浏览器弹出 **UI 风格选型**(12 种风格,点卡选中 → 勾暗黑 → 点「确定风格」)
  100. 2. 终端打印调试台地址 `http://127.0.0.1:8792/`
  101. ### 第 4 步:把风格写进项目
  102. 选型页点「确定风格」会自动复制一行,粘进**项目目录下的** `00_环境.md`(不是任务书):
  103. ```markdown
  104. 风格:5 黏土风 Claymorphism
  105. 风格锁定:否(S3 调整中)
  106. ```
  107. 再启动就不重复问;调试台顶栏显示「风格:5 黏土风(可调)」。
  108. **到这里你已经能改界面了**:调试台里双击代码行编辑,`Ctrl+S` 保存,改坏了点撤销。
  109. ### 第 5 步:S4 冻结后接入调度台(S4.5)
  110. S4 冻结后不是直接开始 S5,先把冻结结果交给工单调度台:
  111. 1. 准备 `00_环境.md`、`S4_冻结记录.md`、基线 tag/commit;
  112. 2. 调度台左侧「+新建项目」,项目存储位置填真实存在的 S4 目录;
  113. 3. 双击项目名改成正式项目名;
  114. 4. 「AI 成员」加入主理人 DSH、执行 AI;大BOSS 是人工席位,留在群里但不执行 AI 工单;
  115. 5. 在项目群 `@主理人` 发标准指令(见流程文档 §2.5);
  116. 6. 主理人输出一页 S5 接入摘要,不得直接写码;
  117. 7. 新建 `S5 方案评审` 工单,门①,备注写 S4 产物完整路径;
  118. 8. 派发器到 `待验` 必须停,`@大BOSS` 拍板后才进入 S6;「演示推进」不算真实签收。
  119. > S4.5 是**交接阶段,不是新门禁**;门①–⑤判据不变。
  120. > **没有调度台**:走 S4.5-Lite,复制 `03_模板/S4_接入卡.md` 填好,人工派单/人工台账;流程不阻断,但不要声称“已自动派单/已自动回件”。
  121. ---
  122. ## 调试台的两个关键特点
  123. | 特点 | 意味着什么 |
  124. |---|---|
  125. | **改 UI = 改源码** | 左边看的页面和右边改的源码是**同一份文件**。双击改、Ctrl+S,源码真的变了——没有"设计稿→写代码"的二次翻译,图码不可能对不上 |
  126. | **自带网格与量尺** | 预览区开 `▦ 网格` 后细格 8px / 粗格 80px,可数格;开 `⌖ 量尺` 点元素会报 x/y/宽高和父内偏移,一键复制——挪 10px 这种精细活不用靠猜 |
  127. | **不干扰多队长分工** | 一个项目 = 一个调试台 = 一份源码。队长分的是"管哪块需求",不是"各拉一套环境"——所以 3 个队长不会出现 3 个版本 |
  128. > 这就是「S4 冻结 = 图即码」能成立的原因:冻结的不是一张图,是一份能跑的源码。
  129. > 详见 `技能简介.html` 第 6 节 或 `技能简介.md` 第七节。
  130. ---
  131. ## 方案图与一页讲清(v4.62)
  132. S5 方案评审要出图、或一个结论要讲给拍板人时,按下面这套来——**图是证据,不是装饰**。
  133. | 场景 | 做法 |
  134. |---|---|
  135. | S5 方案评审要出图 | 先填 `03_模板/方案图_证据卡.md` 再画:主元素挂 `path:line`(每个 ≤3 段),关系证据挂在"拥有它"的元素上 |
  136. | 一次结论要讲清 | 一页讲清四段式:结论先行 → 一题一板 → 编号来源 → 钉 commit(见 `05_方案图与一页讲清.md` §六) |
  137. | 门① 新增三条 | ①图有出处且钉 commit ②没把"可选能力"画成必需边 ③一页讲清里每个结论都有编号来源 |
  138. **三条硬规矩**:配置 ≠ 运行(只有调用点算运行边);职责 ≠ I/O(要找到真 `write`/`execute` 那行);调用者 ≠ 执行者 ≠ 存储(三个断言,不许合成一个框)。
  139. **四类证据不许互相冒充**:结构/布局检查 → 浏览器实测 → 截图 → 人眼评审。没真的看过,不许写"已看过";自动检查通过不等于业务对。
  140. **两次上限**:同一个问题修两次还不好,停下来说清具体缺口(哪个码、哪个对象、哪段测量),不要第三次瞎试。
  141. > 蒸馏自 [Archify 3.2](https://github.com/tt-a1i/archify)(Apache-2.0):只搬判断标准(证据纪律、四类证据、两次上限),不搬它的 Node CLI / 交付锁。详见 `05_方案图与一页讲清.md`。
  142. ---
  143. ## UI 交付与验收(v4.64)
  144. 界面"看着舒服"不靠灵感,靠可核对。**不新增门禁**——这是 S2 出图、S3 批注时该有的做法。
  145. | 环节 | 做法 | 查什么 |
  146. |---|---|---|
  147. | S2 出效果图 | 先立外壳(导航/主区/右栏/弹层挂载点)+ token 层,再填页面 | 颜色字号只走变量,`:root` 之外零 hex |
  148. | S3 看图批注 | 对着状态清单批,不靠"感觉不对" | 列表 8 态、按钮 6 态、输入 7 态、空/错/载三态 |
  149. | 交付/冻结前 | 三查:机器查 → 手点一遍 → 两档截图(1440 / 1280) | hex=0、undefined-var=0、交互断言 true、截图自己看过 |
  150. **六条铁律**(按重要性):①双层 token,组件只用语义层 ②`:root` 之外零 hex ③字号下限 12px,阶梯 12/13/14/17/22/28 ④彩色底用深墨字 ⑤状态色作文字时用 `-deep` 变体 ⑥基础样式写全局类(`.cp`/`.btn`/`.input`),不写深路径。
  151. **只给代码不算交付**:截图 + "点哪里会发生什么" + 状态清单,三样齐。
  152. > 蒸馏自 TRAE 的 `ui-delivery-kit`(纯 Markdown,零依赖):只搬规矩,不引入 Node/构建/npm。完整版见 `06_UI交付与验收.md`,配套明细在 `03_模板/UI交付/`。
  153. ---
  154. ## 多 AI 为什么不会打架
  155. 打架有 9 种形态,每一种都有对应机制:
  156. | 打架形态 | 拦截机制 |
  157. |---|---|
  158. | 同时改同一文件 | **写租约**:同一文件同一时刻只有一个 owner |
  159. | 改同一共享契约 | **契约单写者**:同一 `contract_id` 只能一个 active 租约 |
  160. | 各改各的汇不到一起 | **集成 owner** 统一合入,共享分支禁 rebase |
  161. | 版本错乱 | **三级基线**:base_commit / stage tag / 发布 tag |
  162. | 误删他人文件 | 删除前核对租约与消费者,命中即拒 |
  163. | 迁移冲突 | **迁移串行**,前一迁移验证后才能生成下一个 |
  164. | 密钥/测试数据串用 | 分支隔离凭据,无沙箱第三方禁止并行 |
  165. | 抢端口/硬件 | 独占时间槽登记 |
  166. | 无限开分支 | **停止线**:未合并分支 > 2 暂停派工 |
  167. > **一句话**:打架不是因为 AI 多,是因为"没主"和"无序"。
  168. > 这套流程给了:每块地有主、每次合并有人、每一步有据、每一门有签。
  169. 详见 `技能简介.md` 第三节。
  170. ---
  171. ## 目录说明
  172. ```
  173. 技能包/
  174. ├── SKILL.md ← 你正在读的(入口)
  175. ├── 05_方案图与一页讲清.md ← 【v4.62】图的可校验规矩 + 一页讲清模板(蒸馏自 Archify)
  176. ├── 06_UI交付与验收.md ← 【v4.64】界面怎么算交付:六铁律 + 五步 + 三查 + 十个坑(蒸馏自 ui-delivery-kit)
  177. ├── 技能简介.html ← 【推荐先看】图文版简介(黏土风,双击打开)
  178. ├── 技能简介.md ← 同内容文字版(方便搜索/复制)
  179. ├── 01_流程/
  180. │ └── 20261107_通用开发流程_v4.45.md ← 规则本体(约 1000 行,按需查)
  181. ├── 02_工具/
  182. │ ├── UI调试台.py ← 单文件调试台(左预览 / 右源码 / 双击改)
  183. │ ├── 启动项目.py ← 启动器(先弹风格选型,再起调试台)
  184. │ ├── S4_冻结.py ← 一条命令:锁风格 + 打 tag + 出冻结记录
  185. │ ├── 门禁矩阵.py ← 从说明书抽验收项 + 查漏交付
  186. │ ├── 任务书生成.py ← 依赖图 + 里程碑 + 双口径并行度
  187. │ ├── 问卷转说明书.py ← 问卷答案 → 说明书 §3 骨架(免手抄)
  188. │ └── 复核_*.py / *.js ← 自测脚本(可复跑)
  189. ├── 03_模板/
  190. │ ├── 00_环境.md ← 环境档案模板(复制即用)
  191. │ ├── UI风格选型.html ← 12 种 UI 风格,可点选
  192. │ ├── 模板_问卷引擎.html ← 需求问卷引擎(换 MODEL 即换品类)
  193. │ ├── 问卷生成规范_v1.md ← 问卷怎么造
  194. │ ├── 产品功能说明书_模板_v1.md ← 说明书 11 章模板
  195. │ ├── 20261108_需求确认单_v1.md ← 需求确认单
  196. │ ├── 方案图_证据卡.md ← 【v4.62】门① 出图前先填这张卡
  197. │ └── UI交付/ ← 【v4.64】token 模板 + 状态清单 + 三查手册(theme.template.css / token-spec.md / component-states.md / verify-playbook.md)
  198. └── 04_示例/
  199. ├── 一卡通效果图_v1.html ← 一份 HTML 多页切换的效果图
  200. ├── 最小需求闭环示例_值班表.md ← 10 分钟读完的完整链路
  201. ├── 角色拆分对比_进销存.md ← 6 个 AI 怎么分工
  202. ├── 角色拆分对比_校园一卡通.md ← 9 个 AI 怎么分工
  203. ├── 证据卡_旧版vs新版.html ← 同一批事实:术语体 vs 出门条(左右对照)
  204. ├── 证据卡_旧版vs新版.png ← 同上截图,可直接贴群
  205. ├── 五种图长什么样.html ← 【v4.62】架构/时序/状态/流程/数据流 + 一页讲清,带生活比喻
  206. └── 五种图长什么样.png ← 同上截图
  207. ```
  208. ---
  209. ## 完整流程一览
  210. ```
  211. S-1 环境初始化(四问 → 00_环境.md)
  212. → S0 需求(材料优先)
  213. → S0.1 问卷(按品类生成 + 冲突校验)
  214. → S0.2 需求图
  215. → S1 产品功能说明书 v1.0【唯一权威】
  216. → S1.1 任务书(引用说明书 + 拆分结果)
  217. → S2 效果图(选风格 → 分批出可点图)
  218. → S3 看图批注(调试台改到点头)
  219. → S4 冻结(风格锁定 + 基线)
  220. → S4.5 接入调度台(项目 + 主理人 + 大BOSS + S5 工单草稿)
  221. → S5 方案 →【门①】→ 实施 →【门②③④】→ 终验【门⑤】→ 发版
  222. ```
  223. 详见 `技能简介.md` 第四节。
  224. ---
  225. ## 四条底线
  226. | # | 底线 | 为什么 |
  227. |---|---|---|
  228. | 1 | **写码 与 审 不能是同一个人** | 否则自审自写,门①② 形同虚设 |
  229. | 2 | **构建 与 验收 不能是同一个人** | 否则自己构建自己签,门④ 不存在 |
  230. | 3 | **主理人永远 1 个**,人多加小组队长 | 多头拍板,需求必分裂 |
  231. | 4 | **风格在 S4 冻结之后才锁死** | 没看到效果图就锁死,等于盲签 |
  232. ---
  233. ## 常见问题
  234. **Q:需要装什么?**
  235. - 只看文档、HTML 简介、风格选型页 → **什么都不用装**,双击即可。
  236. - 要跑调试台 / 启动器 → 装 **Python 3.9+**(不用装任何库)。
  237. **Q:需要 git 吗?**
  238. - **工具本身不需要 git**——调试台的备份、撤销用的是 `.history` 目录,不依赖 git。
  239. - 但**流程里的"并行开发、写租约、集成 owner、打 tag"需要 git**。如果你没有 git(或不熟):
  240. - 小项目 → 走**串行**(一次一个人改),用 `.history` 备份即可;
  241. - 多 AI 并行 → 必须有共享 git 仓库,否则只能串行(详见流程 §10.1)。
  242. **Q:Mac 能用吗?**
  243. 能。工具是纯 Python 标准库,无 Windows 专有 API。命令把 `python` 换成 `python3`,路径用 `/`。
  244. **Q:端口 8792 被占用?**
  245. 换端口:`--port 8793`。
  246. **Q:不想用调试台行不行?**
  247. 行,但会失去「点击联动 / 双击改 / 撤销 / 自动备份」。可用 `python -m http.server 8792` 顶替,只是不能编辑。
  248. **Q:一定要三个 AI 吗?**
  249. 标准流程要求 **1 主理人 + 至少 3 个 AI**。少于 3 个只能进"非标准辅助模式"——能起草、能分析、能做局部改动,但**不能签正式门禁、不能宣称可发布**。
  250. **Q:AI 多了会不会打架?**
  251. 会,但有 9 道机制拦。详见 `技能简介.md` 第三节。
  252. **Q:流程文档 1000 行,要全读吗?**
  253. 不用。**必读约 150 行**:§〇 一页纸(21 行)+ S-1 环境初始化(约 80 行)+ §四 五道门(19 行)。其余按需查。
  254. **Q:S4.5 是新门禁吗?会不会绕过门①?**
  255. 不是门禁。S4.5 只是把 S4 冻结产物交给调度台(项目/成员/目录/S5 工单草稿);门①仍由大BOSS拍板,派发器不得自动越过。
  256. **Q:大BOSS 是 AI 吗?**
  257. 不是。大BOSS 是人工拍板席位,不执行 AI 工单、不能把工单派给 `boss`,默认不代替门④独立验收人。**单人项目**允许大BOSS本人兼门④,前提是非写码/构建者,且门④、门⑤分两次签、记录“单人模式”;有第二真人时优先第二真人。主理人(DSH AI)不得兼门④。
  258. **Q:DSH/调度台主理人能自动造 AI 或签门吗?**
  259. 不能。DSH 是协调者,只拆单、派单、汇总、提醒;门①–⑤ 始终由大BOSS拍板。新增 AI 必须由大BOSS在 S-1/AI岗位确认,AI 不得自主调用新增 AI 接口造 AI、不得自动签门。
  260. ---
  261. ## 下一步
  262. | 想做什么 | 读哪 |
  263. |---|---|
  264. | 搞懂"为什么这么设计" | `技能简介.md` |
  265. | 马上上手做项目 | `01_流程/20261107_通用开发流程_v4.45.md` 的 §〇 + S-1 + §四 |
  266. | 看完整例子 | `04_示例/最小需求闭环示例_值班表.md` |
  267. | 看多 AI 怎么分工 | `04_示例/角色拆分对比_校园一卡通.md` |
README.md · README · 78 lines
  1. # 菜鸟开发猿 (Cainiao Dev Ape)
  2. [![Version](https://img.shields.io/badge/version-4.64.0-blue.svg)](https://github.com/b29-ctrl/cainiao-dev-ape/releases)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  4. **菜鸟开发猿**(原名 `dev-workflow-1n1n`)是一套 **「1 主理人 + N 小组队长 + N AI」** 的通用软件开发流程与工具集。它专为单人开发者或小团队设计,帮助你规范从需求立项、方案评审、代码构建到独立验收的全过程,避免 AI 协作过程中的混乱与返工。
  5. > **决策头永远 1 个,执行可以无限加,人多不会打架。**
  6. ## ✨ 核心特性
  7. - **全流程覆盖**:从 S-1 环境初始化、S0 需求问卷、S1 产品功能说明书、S2 效果图、S3 批注,到 S4 风格冻结、S5 方案评审、S6 实施与验收。
  8. - **五道门禁**:方案审、代码审、构建自检、独立验收、终验发版,确保质量。
  9. - **6 个零依赖工具**:基于 Python/HTML,无需安装任何第三方库,开箱即用。
  10. - `S-1_环境初始化.html`:四问勾选器,自动生成环境档案
  11. - `02_工具/UI调试台.py`:左预览右源码,双击改代码,带虚线网格与量尺
  12. - `02_工具/启动项目.py`:先弹风格选型再起调试台
  13. - `02_工具/S4_冻结.py`:锁风格 + 打 tag + 出冻结记录
  14. - `02_工具/门禁矩阵.py`:从说明书抽验收项 + 查漏交付
  15. - `02_工具/任务书生成.py`:依赖图 + 里程碑 + 并行度计算
  16. - **UI 交付六铁律**:针对 AI 生成 UI 的专项验收规范,避免"AI 味"与交互缺陷。
  17. - **方案图证据链**:确保方案图每条连线都有代码/文档出处,防止"配置≠运行"。
  18. ## 🚀 快速开始
  19. ### 1. 作为 DSH (DeepSeek Harness) 技能使用
  20. 如果你正在使用 DeepSeek Harness:
  21. 1. 将本仓库内容放入 `~/.dsh/skills/cainiao-dev-ape/` 目录下。
  22. 2. 在对话中说:**「立项 / 开工 / 走开发流程」** 即可激活。
  23. ### 2. 作为通用 AI 提示词使用
  24. 1. 打开 `SKILL.md`,复制全部内容。
  25. 2. 将其作为 System Prompt 或上下文提供给你的 AI 助手(Claude、GPT-4、DeepSeek 等)。
  26. 3. AI 会严格遵循流程,要求你提供需求、并分步执行。
  27. ### 3. 运行本地工具
  28. 所有工具均为零依赖,仅需 Python 3.9+:
  29. ```bash
  30. # Windows
  31. python 02_工具\启动项目.py --dir "你的项目目录" --port 8792
  32. # macOS / Linux
  33. python3 02_工具/启动项目.py --dir ~/你的项目目录 --port 8792
  34. ```
  35. ## 📂 目录结构
  36. ```
  37. cainiao-dev-ape/
  38. ├── SKILL.md # 技能入口与完整流程定义
  39. ├── 01_流程/ # 通用开发流程本体 (v4.45)
  40. ├── 02_工具/ # 6 个零依赖 Python/HTML 工具
  41. ├── 03_模板/ # 各阶段模板 (环境初始化、说明书、任务书、UI交付等)
  42. ├── 04_示例/ # 示例数据与效果图
  43. ├── 05_方案图与一页讲清.md # 方案图证据链规范
  44. ├── 06_UI交付与验收.md # UI 交付六铁律与验收三查
  45. ├── config.json # 流程配置与阶段定义
  46. ├── 交付须知.md # 授权、商用、改动回传说明
  47. └── 先读我.txt # 人类与 AI 的快速导航
  48. ```
  49. ## 📝 版本历史
  50. - **v4.64.0** (2026-11-16): 并入 UI 交付与验收规范 (六铁律+五步+三查+十坑)。
  51. - **v4.63.0**: 蒸馏 TRAE ui-delivery-kit,强化 UI 交付。
  52. - **v4.62.0**: 蒸馏 Archify,强化方案图证据纪律。
  53. - **v4.45.0**: 流程本体 finalized。
  54. ## 🤝 贡献与反馈
  55. 如果你在使用过程中有任何建议、发现了 Bug,或者想要贡献新的工具/模板,欢迎提交 Issue 或 Pull Request。
  56. ## 📜 许可证
  57. 本项目采用 [MIT License](LICENSE) 开源。
  58. ---
  59. *Designed for humans and AI agents working together.*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.