create-dwy 0.15.0 → 0.16.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/bin/index.js +5 -3
  3. package/package.json +3 -2
  4. package/src/searchable-select.js +419 -0
  5. package/src/skills-install.js +48 -7
  6. package/src/sync-all.js +17 -25
  7. package/src/sync.js +38 -32
  8. package/templates/ai-tools/CHANGELOG.md +76 -0
  9. package/templates/ai-tools/CLAUDE.md +27 -0
  10. package/templates/ai-tools/VERSION +1 -0
  11. package/templates/ai-tools/hook-manifests/hooks.json +7 -0
  12. package/templates/ai-tools/hooks/Git/pre-git-commit-ai-signature-check.sh +57 -0
  13. package/templates/ai-tools/rules/Android/dwy-android-core.md +215 -4
  14. package/templates/ai-tools/rules/Android/dwy-android-pitfalls.md +52 -0
  15. package/templates/ai-tools/rules/Docker/dwy-docker.md +52 -1
  16. package/templates/ai-tools/rules/HarmonyOS/dwy-arkts-ui-build.md +50 -1
  17. package/templates/ai-tools/rules/HarmonyOS/dwy-arkts-ui-design.md +139 -0
  18. package/templates/ai-tools/rules/HarmonyOS/dwy-harmony-pitfalls.md +72 -0
  19. package/templates/ai-tools/rules/Python/dwy-python-backend.md +16 -63
  20. package/templates/ai-tools/rules/Python/dwy-python-base-lib.md +89 -0
  21. package/templates/ai-tools/rules/Python/dwy-python-pitfalls.md +49 -0
  22. package/templates/ai-tools/rules/Vue/dwy-vue-base-lib.md +127 -0
  23. package/templates/ai-tools/rules/Vue/dwy-vue-core.md +22 -86
  24. package/templates/ai-tools/rules/Vue/dwy-vue-pitfalls.md +66 -0
  25. package/templates/ai-tools/rules/iOS/dwy-ios-pitfalls.md +7 -0
  26. package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-dependency-freshness.md +59 -0
  27. package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-git-commit.md +9 -6
  28. package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-tdd-development.md +47 -2
  29. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/SKILL.md +511 -0
  30. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/references/checks-data.md +126 -0
  31. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/references/checks-network.md +88 -0
  32. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/references/checks-runtime.md +195 -0
  33. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/references/security-doc-search.md +179 -0
  34. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_base.sh +39 -0
  35. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_capacity.sh +278 -0
  36. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_db.sh +147 -0
  37. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_docker.sh +230 -0
  38. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_env.sh +64 -0
  39. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_https.sh +60 -0
  40. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_logs.sh +209 -0
  41. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_nginx.sh +100 -0
  42. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_resilience.sh +157 -0
  43. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_secrets.sh +265 -0
  44. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_services.sh +94 -0
  45. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/check_ssh.sh +56 -0
  46. package/templates/ai-tools/skills/unitcircle/uc-deploy-audit/scripts/run_all.sh +105 -0
  47. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-acceptance/SKILL.md +3 -2
  48. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-architecture/SKILL.md +51 -9
  49. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-commercial/SKILL.md +58 -0
  50. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-competitor/SKILL.md +2 -1
  51. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-explore/SKILL.md +83 -0
  52. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-mvp/SKILL.md +2 -1
  53. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-prd/SKILL.md +1 -0
  54. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-product-launcher/SKILL.md +14 -9
  55. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-product-launcher/references/state-and-contract.md +65 -13
  56. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-prototype/SKILL.md +30 -11
  57. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-release/SKILL.md +3 -2
  58. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-stage-design/SKILL.md +17 -10
  59. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-stage-dev/SKILL.md +42 -10
  60. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-stage-launch/SKILL.md +22 -10
  61. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-stage-prd/SKILL.md +13 -4
  62. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-stage-ship/SKILL.md +13 -4
  63. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-tasks/SKILL.md +12 -2
  64. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-tdd-dev/SKILL.md +15 -6
  65. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-validate/SKILL.md +2 -1
  66. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-version/SKILL.md +1 -0
  67. package/templates/ai-tools/skills//345/205/203/345/267/245/345/205/267/dwy-shared/SKILL.md +22 -1
  68. package/templates/ai-tools/skills//345/256/211/345/205/250/dwy-deploy-audit/SKILL.md +1 -1
  69. package/templates/ai-tools/skills//345/256/211/345/205/250/dwy-deploy-audit/references/checks-runtime.md +2 -2
  70. package/templates/ai-tools/skills//345/256/211/345/205/250/dwy-deploy-audit/scripts/check_docker.sh +3 -3
  71. package/templates/ai-tools/skills//345/256/211/345/205/250/dwy-deploy-audit/scripts/check_secrets.sh +1 -1
  72. package/templates/ai-tools/skills//350/277/220/347/273/264/345/217/221/345/270/203/dwy-deploy-first/SKILL.md +176 -0
  73. package/templates/ai-tools/skills//350/277/220/347/273/264/345/217/221/345/270/203/dwy-deploy-first/references/chapter-01-mirrors.md +112 -0
  74. package/templates/ai-tools/skills//344/272/247/345/223/2010/345/210/2601/dwy-ideate/SKILL.md +0 -21
  75. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-0to1/SKILL.md +0 -113
  76. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-0to1/templates/STATE.md +0 -56
  77. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-dev-qa/SKILL.md +0 -117
  78. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-market-analysis/SKILL.md +0 -92
  79. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-prd-coarse/SKILL.md +0 -72
  80. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-prd-coarse/templates/prd-coarse.md +0 -61
  81. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-prd-detailed/SKILL.md +0 -76
  82. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-prd-detailed/templates/prd-detailed.md +0 -119
  83. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-prototype/SKILL.md +0 -104
  84. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-spike/SKILL.md +0 -81
  85. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-tdd-dev/SKILL.md +0 -212
  86. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-tdd-dev/templates/impl-plan.md +0 -115
  87. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-tech-feasibility/SKILL.md +0 -105
  88. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-version-plan/SKILL.md +0 -64
  89. package/templates/ai-tools/skills//345/274/200/345/217/221/346/265/201/347/250/213/dwy-version-plan/templates/version-plan.md +0 -72
@@ -1,105 +0,0 @@
1
- ---
2
- name: dwy-tech-feasibility
3
- description: 技术可行性与选型调研:为产品核心能力找 1-3 个成熟开源方案做对比,给推荐 + 是否需要实测建议,绝不手撸已有轮子。涉及以下场景使用此 skill(即使没点名 'dwy-tech-feasibility'):用户说『这个功能用什么技术实现』『帮我做技术选型/可行性分析』『有没有现成的库做 X』『这个能力技术上可行吗』。WebSearch 找方案 + 四项对比表(能力覆盖/成熟度/适配度/坑)+ 敢下判断的推荐。区分:本 skill 是选型可行性调研(纸面对比);要真写代码跑通用 dwy-spike;要推荐整套项目技术栈用 dwy-tech-stack;完整 0→1 流水线用 dwy-0to1。
4
- ---
5
-
6
- # dwy-tech-feasibility · 技术可行性
7
-
8
- 找 1-3 个成熟方案实现产品核心能力,**绝不手撸**。选对省半年,选错返工到死。同时判断要不要先写代码实测核心风险。
9
-
10
- ## 运行模式
11
-
12
- 上下文自适应,两种调用方式:
13
-
14
- - **单独调用(默认)**:用户直接问某能力怎么实现 / 选什么技术。从用户描述的能力起步;产物落 `./tech-feasibility.md` 或用户指定位置;**不读写 STATE.md、不依赖 `docs/0to1/`**。做完跑下方「门」即结束。
15
- - **流水线调用**:`dwy-0to1` 调用,指令含「流水线模式」+ 前序产物路径(市场分析)+ 落盘路径(如 `docs/0to1/02-tech-feasibility.md`)。按指令读前序、写指定路径;**STATE 记账由 dwy-0to1 负责,本 skill 不碰 STATE.md**。
16
-
17
- ## 输入(核心能力从哪来)
18
-
19
- - 单独模式:从用户描述里拎出要实现的核心能力;不清楚就先问一句产品要做什么。
20
- - 流水线模式:读编排器给的市场分析产物,拿到**核心能力 / 最大技术风险假设**和**硬约束**(合规/PII/实时性/规模水位)——硬约束直接决定哪些方案能选。
21
-
22
- 技术调研只围绕**核心能力**转,别给还没定的边角功能选型。
23
-
24
- ## 怎么做
25
-
26
- 铁律:**先搜后造**,优先成熟开源方案,禁止手写已有主流方案的功能。
27
-
28
- ### 一、WebSearch 找方案(1-3 个)
29
-
30
- 1. 拆出产品的**核心技术能力**(如「实时语音转文字」「PDF 解析」「本地向量检索」),逐个搜主流实现。
31
- 2. 搜的标准(沿用 dwy「优先成熟开源方案」):
32
- - npm / PyPI / GitHub **stars > 1k**
33
- - **近期有维护**(近半年有 commit / release)
34
- - 社区主流,不是冷门小众
35
- 3. 每个能力列 **1-3 个**候选方案,别只列一个(没对比说不清推荐)。
36
-
37
- ### 二、目标技术栈没有合适库 → 跨语言参考
38
-
39
- 目标语言/栈里搜不到合适方案,但**别的语言有成熟库** → 推荐那个库**供参考实现**,讲清两件事:
40
- - 怎么参考:照它的核心算法/数据结构思路自己实现,还是直接调(子进程 / FFI / 服务化)。
41
- - 怎么移植:关键逻辑在哪、移植难点是什么。
42
-
43
- - ❌ 目标是 Python 但只有 Rust 有成熟库 → 直接说「没方案,自己写」
44
- - ✅ 「核心算法 Rust 的 `xxx`(stars 8k)最成熟。两条路:① 用 PyO3 包成 Python 扩展直接调;② 照它的 `core/` 算法思路用 Python 重写,难点在 SIMD 那段。推荐 ①,省事且不丢性能。」
45
-
46
- ### 三、每个方案给四项 + 推荐
47
-
48
- 每个候选方案列:
49
-
50
- | 项 | 说什么 |
51
- |----|--------|
52
- | 能力覆盖 | 核心能力它能做到几成,缺什么 |
53
- | 成熟度 | stars / 维护活跃度 / 生产案例 |
54
- | 适配度 | 跟产品技术栈、部署形态合不合、**能否满足硬约束**(合规/实时性/规模) |
55
- | 坑 | 已知限制、license、性能/体积代价 |
56
-
57
- 最后给 **推荐方案 + 理由**(敢下判断,别全列让用户猜),并说明推荐方案**如何满足硬约束**;若某硬约束无方案可满足,明确标红为风险。
58
-
59
- ### 四、判断要不要写代码实测
60
-
61
- | 判断 | 信号 | 建议 |
62
- |------|------|------|
63
- | **建议实测** | 有技术风险/不确定:新算法、硬件集成、性能未知、第三方 API 行为不明、跨语言移植没把握 | 接 dwy-spike 先写丢弃式 POC 验核心流程 |
64
- | **跳过实测** | 技术成熟无悬念、方案有大量生产案例、就是常规 CRUD/调 API | 直接进开发,不必 spike |
65
-
66
- 把建议写进产物,给用户拍板。
67
-
68
- ## 产物
69
-
70
- 落盘技术可行性文档(单独默认 `./tech-feasibility.md`;流水线按编排器给的路径)。frontmatter:
71
-
72
- ```markdown
73
- ---
74
- status: done # 落盘且过门后才填 done;过门前 awaiting-approval
75
- updated: <date +%Y-%m-%d>
76
- ---
77
- ```
78
-
79
- 正文必含:
80
-
81
- | 块 | 内容 |
82
- |----|------|
83
- | 核心能力清单 | 产品要实现哪几项关键技术能力 |
84
- | 方案对比表 | 每个能力 1-3 个候选,列 能力覆盖/成熟度/适配度/坑 |
85
- | 跨语言参考 | 如有:推荐别的语言的库 + 怎么参考/移植 |
86
- | 推荐方案 | 选哪个 + 理由(敢下判断)+ 如何满足硬约束 |
87
- | 是否实测建议 | 建议实测(说清验什么风险)/ 跳过(说清为什么无悬念) |
88
-
89
- ## 门(过门确认)
90
-
91
- 落盘后先**自己核一遍**(先验证再声称):每个核心能力都有候选吗、对比表四项填全了吗、推荐有理由吗、实测建议明确吗。
92
-
93
- 然后 `AskUserQuestion` 摆**方案对比 + 推荐**,问:
94
-
95
- > 选哪个方案?要不要先写代码实测核心流程再往下走?
96
-
97
- 让用户同时定下「技术方案」和「是否实测」两件事。
98
-
99
- ## 边界 / 禁止
100
-
101
- - **绝不手撸已有主流方案**——搜得到成熟库就用/参考,搜不到才自己写,且要在产物里写清「调研了哪些、为何都不用」。
102
- - **每个核心能力至少给候选,不能空着说「自己实现」**——除非确认无任何开源方案。
103
- - **推荐必须带理由,不和稀泥**——不「都可以,看你」。
104
- - **目标栈无库时别直接放弃**——先看跨语言有没有成熟方案可参考/移植。
105
- - 这步**只调研和选型,不写实现代码**。要验证可行性是 dwy-spike 干的事。
@@ -1,64 +0,0 @@
1
- ---
2
- name: dwy-version-plan
3
- description: 产品版本规划:基于细 PRD 把产品切成可交付版本(v1 最小闭环 → v2 → v3…),每版写包含功能、依赖、可验证的验收标准,按价值增量切不按技术层切。涉及以下场景使用此 skill(即使没点名 'dwy-version-plan'):用户说『帮我规划版本/迭代』『这个产品先做哪些功能、怎么分版本』『切个 v1 最小可用版本』『排个版本路线』。区分:本 skill 切版本+定验收;具体某版本的 TDD 实现用 dwy-tdd-dev;完整 0→1 流水线用 dwy-0to1。
4
- ---
5
-
6
- # dwy-version-plan · 版本规划
7
-
8
- 基于细 PRD 把产品切成若干可交付版本:v1 最小可用闭环 → v2 → v3…,每个版本是一个能独立交付的增量。
9
-
10
- ## 运行模式
11
-
12
- 上下文自适应,两种调用方式:
13
-
14
- - **单独调用(默认)**:用户直接让你规划版本。从用户给的 PRD/功能清单或描述起步;产物落 `./version-plan.md` 或用户指定位置;**不读写 STATE.md、不依赖 `docs/0to1/`**。做完跑下方「门」即结束。
15
- - **流水线调用**:`dwy-0to1` 调用,指令含「流水线模式」+ 前序产物路径(细 PRD)+ 落盘路径(如 `docs/0to1/06-version-plan.md`)。**STATE 记账(含选定版本、版本进度表)由 dwy-0to1 负责,本 skill 不碰 STATE.md**。
16
-
17
- ## 输入(切版本的依据)
18
-
19
- - **细 PRD 是切版本的唯一依据**:每个版本包含哪些功能,必须能映射回 PRD 的具体页面 / 功能,不能凭空加。
20
- - 看目标端和产品定位,版本节奏按端和定位定。
21
- - 单独模式:用户没给细 PRD 就先问清有哪些功能/页面、核心价值是什么,再切。
22
-
23
- ## 怎么做(具体步骤)
24
-
25
- 套 `templates/version-plan.md`,按下面思路切:
26
-
27
- 0. **先勾勒全局数据模型 + 架构骨架(跨版本一次性)** — 切版本前先定核心实体、实体间关系、2-3 句架构方向(分层 / 存储 / 关键边界)。这是所有版本共用的地基,先定好才能避免 v1 把表结构 / 架构画死、v2 被迫 DB 迁移。轻量草图即可,不下到字段类型级(那是 Step9 实施计划的事)。
28
- 1. **找 v1 最小闭环** — 从 PRD 里挑出「能跑通核心价值的最小一条路径」。用户能完整走完一次主流程、拿到核心价值,就是 v1。砍掉一切锦上添花。
29
- - ✅ 笔记 App v1 = 新建 / 编辑 / 列表 / 删除,一条闭环
30
- - ❌ v1 塞进多端同步、协作、AI 摘要、主题皮肤——这些进 v2+
31
- 2. **后续版本按价值增量切** — v2、v3 每个加一组**能独立交付**的功能。不要按技术层切(「v1 做后端、v2 做前端」是错的,那不是可交付增量)。
32
- 3. **大胆切大版本** — AI 写代码效率高,单版本可以比传统排期装更多。判据是「这一版能不能独立交付、独立验收」,不是「工时够不够一个 sprint」。能合并成一个能交付的闭环就别拆碎。
33
- 4. **写清依赖** — 哪个版本依赖前序版本的产物 / 数据结构。一般 v2 依赖 v1,但要显式写出来依赖的是什么(如「v2 的搜索依赖 v1 已落地的笔记表结构」)。
34
- 5. **每版写验收标准** — 这一版做完,怎么算「真的做完了」。要可验证:列出用户能完成的动作 + 可观测的结果,开发的完成前验证就照这个核对。
35
-
36
- 每个版本一节,写全:**目标(一句话)/ 包含功能(对应 PRD 哪些页面 / 功能)/ 依赖前序版本 / 验收标准**。
37
-
38
- ## 产物
39
-
40
- 落盘版本规划(单独默认 `./version-plan.md`;流水线按编排器给的路径)。套 `templates/version-plan.md`(含版本总览 + 每版本一节 + 一个填好的示例)。frontmatter:
41
-
42
- ```
43
- ---
44
- status: done
45
- updated: <date +%Y-%m-%d>
46
- ---
47
- ```
48
-
49
- 成稿要件:全局数据模型 / 架构骨架已勾勒;每个版本的「包含功能」都能映射回细 PRD 的具体页面 / 功能;v1 是最小可用闭环;依赖关系写清;每版有可验证的验收标准。落盘后核对:把版本里列的功能逐条回查细 PRD,确认没有 PRD 里没有的功能、也没把核心闭环拆散到多个版本,再声称完成(先验证再声称)。
50
-
51
- ## 门(过门确认)
52
-
53
- 用 `AskUserQuestion` 把版本建议摆给用户:
54
- - 摆什么:各版本一句话目标 + 包含的主要功能 + 依赖关系(建议方案)。
55
- - 问什么:「**这次做哪几个版本?(可多选)**」选项给 v1 / v2 / v3… 让用户勾选要一起做的版本,外加「调整切法」。
56
-
57
- 用户选定后,要改切法就改,直到确认。
58
-
59
- ## 边界 / 禁止
60
-
61
- - **禁止脱离细 PRD 凭空加功能**——版本里每个功能都要能指回 PRD 某页 / 某功能。
62
- - **禁止按技术层切版本**(后端版 / 前端版)——每个版本必须是能独立交付、独立验收的增量。
63
- - **禁止把核心闭环拆碎**——v1 必须自己就能跑通核心价值,不能「v1 只有界面没逻辑」。
64
- - **禁止漏依赖和验收标准**——每版都要写清依赖什么、怎么算做完。
@@ -1,72 +0,0 @@
1
- ---
2
- status: draft # draft | done
3
- updated: <YYYY-MM-DD>
4
- ---
5
-
6
- # <产品名> · 版本规划
7
-
8
- > 基于细 PRD 把产品切成可交付版本。v1 = 最小可用闭环,往后每版是能独立交付、独立验收的增量。每个版本的功能都要能映射回细 PRD 的具体页面 / 功能。
9
-
10
- ## 全局数据模型 / 架构骨架
11
-
12
- > 跨版本一次性定的地基,避免 v1 把结构画死、v2 被迫迁移。轻量草图,不下到字段类型级。
13
-
14
- - **核心实体**:<实体 A、实体 B…,各一句话职责>
15
- - **实体关系**:<A 1:N B、B M:N C… 关键关系>
16
- - **架构方向**:<2-3 句:分层 / 存储选型 / 关键边界,如「前端 SPA + REST 后端 + Postgres;鉴权走 JWT;文件走对象存储」>
17
-
18
- ## 版本总览
19
-
20
- | 版本 | 一句话目标 | 依赖 |
21
- |------|-----------|------|
22
- | v1 | <最小可用闭环目标> | 无 |
23
- | v2 | <在 v1 上加的价值增量> | v1 |
24
- | v3 | <下一个增量> | v2 |
25
-
26
- ---
27
-
28
- ## 示例(填好的样板,照这个颗粒度写每一版)
29
-
30
- ### v1:能写能看的笔记闭环
31
-
32
- - **目标**:用户能新建、编辑、查看、删除笔记,一条完整可用闭环。
33
- - **包含功能**(对应细 PRD 页面 / 功能):
34
- - 笔记列表页(PRD 页面 1):列表展示、空态、下拉刷新
35
- - 新建 / 编辑页(PRD 页面 2):标题 + 正文输入(含前后端长度上限)、保存
36
- - 删除(PRD 页面 1 的滑动删除 + 二次确认)
37
- - **依赖前序版本**:无(首版)。
38
- - **验收标准**:
39
- - [ ] 新建一条笔记 → 列表出现该笔记
40
- - [ ] 编辑后 → 列表与详情内容同步更新
41
- - [ ] 删除 + 确认 → 列表移除该笔记
42
- - [ ] 正文超 5000 字 → 前端截断 + 提示,后端拒绝返回 422
43
- - [ ] 全量测试通过、构建 exit 0
44
-
45
- ### v2:搜索 + 标签
46
-
47
- - **目标**:笔记多起来后能快速找到。
48
- - **包含功能**(对应细 PRD 页面 / 功能):
49
- - 搜索页(PRD 页面 3):关键词搜索、结果高亮、零结果态
50
- - 标签(PRD 页面 2 的标签选择 + 页面 1 的标签筛选)
51
- - **依赖前序版本**:v1(依赖 v1 已落地的笔记表结构与列表页)。
52
- - **验收标准**:
53
- - [ ] 输入关键词 → 匹配的笔记按相关度返回,命中词高亮
54
- - [ ] 无匹配 → 显示零结果态文案
55
- - [ ] 给笔记打标签 → 列表可按标签筛选
56
- - [ ] 全量测试通过、构建 exit 0
57
-
58
- ---
59
-
60
- ## 空白版本模板(每个真实版本复制一份填)
61
-
62
- ### vN:<版本名>
63
-
64
- - **目标**:<一句话,这一版让用户能完成什么>
65
- - **包含功能**(对应细 PRD 页面 / 功能):
66
- - <功能 A>(PRD 页面 X)
67
- - <功能 B>(PRD 页面 Y)
68
- - **依赖前序版本**:<无 / vM,依赖 vM 的什么产物或数据结构>
69
- - **验收标准**(可验证、对得上「用户能完成的动作 + 可观测结果」):
70
- - [ ] <动作 → 可观测结果>
71
- - [ ] <用户输入的长度上限边界 → 预期行为>
72
- - [ ] 全量测试通过、构建 exit 0