adspecs 0.1.19 → 0.1.21

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 (74) hide show
  1. package/.adspecs/feature.json +16 -16
  2. package/.adspecs/feature.yml +28 -28
  3. package/.adspecs/paths.json +17 -17
  4. package/.adspecs/templates/04-/345/211/215/347/253/257/345/212/237/350/203/275/350/256/276/350/256/241/346/250/241/346/235/277.md +1 -1
  5. package/.adspecs/templates/05-/345/220/216/347/253/257/344/273/273/345/212/241/346/270/205/345/215/225/346/250/241/346/235/277.md +613 -724
  6. package/.adspecs/templates/05b-/345/211/215/347/253/257/344/273/273/345/212/241/346/270/205/345/215/225/346/250/241/346/235/277.md +51 -51
  7. package/.claude-plugin/marketplace.json +23 -23
  8. package/.claude-plugin/plugin.json +18 -18
  9. package/.qoder-plugin/plugin.json +31 -31
  10. package/CLAUDE.md +1 -5
  11. package/INSTALL.md +3 -3
  12. package/README.md +395 -395
  13. package/bin/adspecs.js +129 -129
  14. package/hooks/commit-queue.js +245 -245
  15. package/hooks/hooks.json +63 -63
  16. package/hooks/session-start.js +44 -44
  17. package/hooks/wiki-queue.js +127 -127
  18. package/package.json +61 -61
  19. package/references/ant6-front-standard/index.md +99 -99
  20. package/references/antd-front-demo/public/mockServiceWorker.js +361 -361
  21. package/references/ecp-end-standard/index.md +63 -63
  22. package/references/python-end-standard/01-Python/345/220/216/347/253/257/347/274/226/347/240/201/350/247/204/350/214/203.md +372 -372
  23. package/references/python-end-standard/02-/346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/344/270/216/344/275/277/347/224/250/350/247/204/350/214/203.md +226 -226
  24. package/references/python-end-standard/03-Celery/345/274/202/346/255/245/344/273/273/345/212/241/350/247/204/350/214/203.md +237 -237
  25. package/references/python-end-standard/04-Redis/344/275/277/347/224/250/350/247/204/350/214/203.md +231 -231
  26. package/scripts/postinstall.js +107 -107
  27. package/scripts/sync-version.js +105 -105
  28. package/skills/.claude/.wiki-update-queue +26 -26
  29. package/skills/adspecs-constitution/SKILL.md +157 -0
  30. package/skills/adspecs-export-word/SKILL.md +498 -498
  31. package/skills/adspecs-export-word/references/md-to-docx.js +862 -862
  32. package/skills/adspecs-export-word/references/package-lock.json +220 -220
  33. package/skills/adspecs-export-word/references/package.json +10 -10
  34. package/skills/adspecs-front-prototype/SKILL.md +405 -405
  35. package/skills/adspecs-front-spec/SKILL.md +4 -4
  36. package/skills/adspecs-front-tasks/SKILL.md +213 -173
  37. package/skills/adspecs-plan/SKILL.md +59 -69
  38. package/skills/adspecs-prd/SKILL.md +13 -5
  39. package/skills/adspecs-prd-to-demo/SKILL.md +532 -0
  40. package/skills/adspecs-tasks/SKILL.md +175 -204
  41. package/skills/adspecs-update-status/SKILL.md +382 -382
  42. package/skills/adspecs-utest/SKILL.md +107 -116
  43. package/skills/grill-me/SKILL.md +7 -0
  44. package/skills/grill-me/agents/openai.yaml +5 -0
  45. package/skills/playwright-cli/SKILL.md +420 -0
  46. package/skills/playwright-cli/references/element-attributes.md +23 -0
  47. package/skills/playwright-cli/references/playwright-tests.md +39 -0
  48. package/skills/playwright-cli/references/request-mocking.md +87 -0
  49. package/skills/playwright-cli/references/running-code.md +241 -0
  50. package/skills/playwright-cli/references/session-management.md +225 -0
  51. package/skills/playwright-cli/references/storage-state.md +275 -0
  52. package/skills/playwright-cli/references/test-generation.md +433 -0
  53. package/skills/playwright-cli/references/tracing.md +139 -0
  54. package/skills/playwright-cli/references/video-recording.md +143 -0
  55. package/skills/playwright-trace/SKILL.md +171 -0
  56. package/skills/project-init/SKILL.md +93 -22
  57. package/skills/project-init/references/front-demo/.claude/settings.local.json +9 -0
  58. package/skills/wiki-update/SKILL.md +232 -232
  59. package/src/commands/doctor.js +197 -197
  60. package/src/commands/init.js +83 -83
  61. package/src/commands/plugin.js +165 -165
  62. package/src/commands/update.js +87 -87
  63. package/src/lib/area-scanner.js +129 -129
  64. package/src/lib/copier.js +104 -104
  65. package/src/lib/dir-utils.js +161 -133
  66. package/src/lib/json-merge.js +114 -114
  67. package/src/lib/paths-defaults.js +37 -37
  68. package/src/lib/prompts.js +428 -347
  69. package/src/lib/readme-gen.js +143 -143
  70. package/src/lib/report.js +338 -327
  71. package/src/lib/scaffolder.js +551 -518
  72. package/src/lib/short-name.js +36 -36
  73. package/src/utils.js +80 -80
  74. package/references/antd-front-demo/.env +0 -15
package/references/ecp-end-standard/index.md CHANGED
@@ -1,63 +1,63 @@
1
- # 后端集成开发规范索引
2
-
3
- 本目录包含后端（Java / Spring Boot）集成开发规范。生成或修改后端代码前，先按任务类型读取对应规范。
4
-
5
- ---
6
-
7
- ## 文件清单
8
-
9
- | 序号 | 文件名 | 主要内容 |
10
- | ---- | ------ | -------- |
11
- | 01 | [后端分层开发与数据库设计规范.md](./后端分层开发与数据库设计规范.md) | Controller / Service / Manager / DAO 分层约束、数据库设计强制规则 |
12
- | 02 | [多语言及全局异常处理规范.md](./多语言及全局异常处理规范.md) | 异常必须在 Server 层抛出、多语言消息、全局异常拦截 |
13
- | 03 | [Liquibase 数据库变更管理规范.md](./Liquibase%20数据库变更管理规范.md) | 所有数据库变更必须走 Liquibase，禁止直接执行 SQL 不补录 |
14
- | 04 | [Redis使用规范.md](./Redis使用规范.md) | 优先使用 `DawnRedis`，Key 命名规范、过期策略 |
15
- | 05 | [ES使用规范.md](./ES使用规范.md) | 基于 `sieiot-es-plus-starter`（ES 8.x）静态链式 API 操作 Elasticsearch |
16
- | 06 | [分布式锁规范.md](./分布式锁规范.md) | 两种分布式锁方式（Redis / 注解）适用场景与用法 |
17
- | 07 | [IdToName使用规范.md](./IdToName使用规范.md) | 字段注解 + 方法开关注解 + AOP 自动完成 ID → 名称填充 |
18
- | 08 | [编码自动生成规范.md](./编码自动生成规范.md) | 业务编码（客户、供应商、订单等）统一通过 `AutoCodeRuleService` 生成 |
19
- | 09 | [文件中心使用规范.md](./文件中心使用规范.md) | 平台文件中心 `IotBaseAttachmentClient` 统一附件管理 |
20
- | 10 | [流程中心接入规范.md](./流程中心接入规范.md) | 业务单据接入 BPM 流程中心（Kafka 异步 + 状态回调） |
21
- | 11 | [通用工具类使用规范.md](./通用工具类使用规范.md) | 平台通用工具类选型约束，避免重复造轮子 |
22
-
23
- ---
24
-
25
- ## 按场景推荐阅读
26
-
27
- ### 新增业务模块（建工程）
28
-
29
- 1. `后端分层开发与数据库设计规范.md` — 先确定分层结构与数据库规范
30
- 2. `多语言及全局异常处理规范.md` — 异常处理与多语言消息
31
- 3. `Liquibase 数据库变更管理规范.md` — 数据库变更管理流程
32
- 4. `通用工具类使用规范.md` — 避免重复造轮子
33
-
34
- ### 新增 CRUD 接口
35
-
36
- 1. `后端分层开发与数据库设计规范.md` — 分层约束
37
- 2. `编码自动生成规范.md` — 业务编码生成
38
- 3. `IdToName使用规范.md` — 列表返回时自动翻译 ID 为名称
39
- 4. `多语言及全局异常处理规范.md` — 异常抛出与提示
40
-
41
- ### 涉及缓存 / 搜索 / 锁
42
-
43
- 1. `Redis使用规范.md` — 缓存读写
44
- 2. `ES使用规范.md` — 全文检索 / 复杂查询
45
- 3. `分布式锁规范.md` — 并发控制
46
-
47
- ### 文件 / 流程 / 附件
48
-
49
- 1. `文件中心使用规范.md` — 附件上传 / 查询 / 删除
50
- 2. `流程中心接入规范.md` — BPM 审批流接入
51
-
52
- ### 数据库变更
53
-
54
- 1. `Liquibase 数据库变更管理规范.md` — 强制走 Liquibase
55
- 2. `后端分层开发与数据库设计规范.md` — 表结构与索引设计约束
56
-
57
- ---
58
-
59
- ## 维护说明
60
-
61
- - 新增规范文件时，同步更新本索引。
62
- - 规范文件命名使用中文，便于阅读；文件名中的空格在链接中需要 URL 编码（如 `%20`）。
63
- - 本目录规范与 `ant6-front-integration/`（前端规范）、`yudaocloud-end-integration/`（ECP 后端集成）互补，按技术栈选用。
1
+ # 后端集成开发规范索引
2
+
3
+ 本目录包含后端（Java / Spring Boot）集成开发规范。生成或修改后端代码前，先按任务类型读取对应规范。
4
+
5
+ ---
6
+
7
+ ## 文件清单
8
+
9
+ | 序号 | 文件名 | 主要内容 |
10
+ | ---- | ------ | -------- |
11
+ | 01 | [后端分层开发与数据库设计规范.md](./后端分层开发与数据库设计规范.md) | Controller / Service / Manager / DAO 分层约束、数据库设计强制规则 |
12
+ | 02 | [多语言及全局异常处理规范.md](./多语言及全局异常处理规范.md) | 异常必须在 Server 层抛出、多语言消息、全局异常拦截 |
13
+ | 03 | [Liquibase 数据库变更管理规范.md](./Liquibase%20数据库变更管理规范.md) | 所有数据库变更必须走 Liquibase，禁止直接执行 SQL 不补录 |
14
+ | 04 | [Redis使用规范.md](./Redis使用规范.md) | 优先使用 `DawnRedis`，Key 命名规范、过期策略 |
15
+ | 05 | [ES使用规范.md](./ES使用规范.md) | 基于 `sieiot-es-plus-starter`（ES 8.x）静态链式 API 操作 Elasticsearch |
16
+ | 06 | [分布式锁规范.md](./分布式锁规范.md) | 两种分布式锁方式（Redis / 注解）适用场景与用法 |
17
+ | 07 | [IdToName使用规范.md](./IdToName使用规范.md) | 字段注解 + 方法开关注解 + AOP 自动完成 ID → 名称填充 |
18
+ | 08 | [编码自动生成规范.md](./编码自动生成规范.md) | 业务编码（客户、供应商、订单等）统一通过 `AutoCodeRuleService` 生成 |
19
+ | 09 | [文件中心使用规范.md](./文件中心使用规范.md) | 平台文件中心 `IotBaseAttachmentClient` 统一附件管理 |
20
+ | 10 | [流程中心接入规范.md](./流程中心接入规范.md) | 业务单据接入 BPM 流程中心（Kafka 异步 + 状态回调） |
21
+ | 11 | [通用工具类使用规范.md](./通用工具类使用规范.md) | 平台通用工具类选型约束，避免重复造轮子 |
22
+
23
+ ---
24
+
25
+ ## 按场景推荐阅读
26
+
27
+ ### 新增业务模块（建工程）
28
+
29
+ 1. `后端分层开发与数据库设计规范.md` — 先确定分层结构与数据库规范
30
+ 2. `多语言及全局异常处理规范.md` — 异常处理与多语言消息
31
+ 3. `Liquibase 数据库变更管理规范.md` — 数据库变更管理流程
32
+ 4. `通用工具类使用规范.md` — 避免重复造轮子
33
+
34
+ ### 新增 CRUD 接口
35
+
36
+ 1. `后端分层开发与数据库设计规范.md` — 分层约束
37
+ 2. `编码自动生成规范.md` — 业务编码生成
38
+ 3. `IdToName使用规范.md` — 列表返回时自动翻译 ID 为名称
39
+ 4. `多语言及全局异常处理规范.md` — 异常抛出与提示
40
+
41
+ ### 涉及缓存 / 搜索 / 锁
42
+
43
+ 1. `Redis使用规范.md` — 缓存读写
44
+ 2. `ES使用规范.md` — 全文检索 / 复杂查询
45
+ 3. `分布式锁规范.md` — 并发控制
46
+
47
+ ### 文件 / 流程 / 附件
48
+
49
+ 1. `文件中心使用规范.md` — 附件上传 / 查询 / 删除
50
+ 2. `流程中心接入规范.md` — BPM 审批流接入
51
+
52
+ ### 数据库变更
53
+
54
+ 1. `Liquibase 数据库变更管理规范.md` — 强制走 Liquibase
55
+ 2. `后端分层开发与数据库设计规范.md` — 表结构与索引设计约束
56
+
57
+ ---
58
+
59
+ ## 维护说明
60
+
61
+ - 新增规范文件时，同步更新本索引。
62
+ - 规范文件命名使用中文，便于阅读；文件名中的空格在链接中需要 URL 编码（如 `%20`）。
63
+ - 本目录规范与 `ant6-front-integration/`（前端规范）、`yudaocloud-end-integration/`（ECP 后端集成）互补，按技术栈选用。