ai-project-manage-cli 7.1.39 → 8.0.2
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.
- package/README.md +6 -8
- package/dist/index.js +3454 -7707
- package/dist/webide-message-worker.js +320 -796
- package/package.json +1 -2
- package/template/AGENTS.md +0 -56
- package/template/apm.config.json +0 -3
- package/template/project/.gitkeep +0 -0
- package/template/rules/reply.md +0 -16
- package/template/rules/write_doc.md +0 -39
- package/template/sessions/.gitkeep +0 -0
- package/template/skills/apm-apply-change/SKILL.md +0 -116
- package/template/skills/apm-confirm-assumptions/SKILL.md +0 -3
- package/template/skills/apm-dev/SKILL.md +0 -80
- package/template/skills/apm-diff-review/SKILL.md +0 -63
- package/template/skills/apm-propose/SKILL.md +0 -52
- package/template/skills/apm-propose/design.md +0 -37
- package/template/skills/apm-propose/proposal.md +0 -31
- package/template/skills/apm-propose/specs.md +0 -39
- package/template/skills/apm-propose/tasks.md +0 -16
- package/template/skills/apm-recap/SKILL.md +0 -77
- package/template/skills/apm-recap/recap-template.md +0 -121
- package/template/skills/apm-update-plan/SKILL.md +0 -26
- package/template/skills/apm-write-assumptions/SKILL.md +0 -78
- package/template/skills/apm-write-assumptions/assumptions-template.md +0 -18
- package/template/skills/apm-write-backend-api/SKILL.md +0 -40
- package/template/skills/apm-write-backend-api/api-template.md +0 -35
- package/template/skills/apm-write-backend-api/backend-template.md +0 -41
- package/template/skills/apm-write-checklist/SKILL.md +0 -42
- package/template/skills/apm-write-checklist/checklist-template.md +0 -34
- package/template/skills/apm-write-frontend-plan/SKILL.md +0 -27
- package/template/skills/apm-write-frontend-plan/plan-template.md +0 -40
- package/template/skills/apm-write-plan/SKILL.md +0 -51
- package/template/skills/apm-write-plan/api-template.md +0 -35
- package/template/skills/apm-write-plan/plan-template.md +0 -72
- package/template/skills/apm-write-prd/SKILL.md +0 -14
- package/template/skills/apm-write-prd/template.md +0 -134
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
# 计划文档模板
|
|
2
|
-
|
|
3
|
-
> 后端写 `docs/BACKEND-PLAN.md` + `docs/API.md`(两份文档禁止合并)。
|
|
4
|
-
> 前端写 `docs/FRONTEND-PLAN.md` + `docs/FRONTEND-ASSUMPTIONS.md`。
|
|
5
|
-
> 假设写在独立的 `*-ASSUMPTIONS.md`,计划内仅保留摘要与链接。
|
|
6
|
-
|
|
7
|
-
## 后端计划(BACKEND-PLAN.md)
|
|
8
|
-
|
|
9
|
-
```markdown
|
|
10
|
-
# <需求名> · 后端实现计划
|
|
11
|
-
|
|
12
|
-
## 1. 需求理解
|
|
13
|
-
|
|
14
|
-
用 3 ~ 5 行复述本端要做什么(产品语言),不复制需求原文。
|
|
15
|
-
|
|
16
|
-
## 2. 依据与待确认口径
|
|
17
|
-
|
|
18
|
-
### 依据(口径 + 来源)
|
|
19
|
-
|
|
20
|
-
| # | 口径 | 来源 |
|
|
21
|
-
| --- | ------------------------------ | ----------------------------- |
|
|
22
|
-
| 1 | 「是否加分」与「是否扣分」互斥 | 需求原文第 1 条 |
|
|
23
|
-
|
|
24
|
-
### 待确认口径
|
|
25
|
-
|
|
26
|
-
本端有 **N** 项待项目经理确认,详见 [BACKEND-ASSUMPTIONS.md](./BACKEND-ASSUMPTIONS.md)。确认前不开始开发。
|
|
27
|
-
|
|
28
|
-
> N 与链接由 sync ASSUMPTIONS 时服务端自动更新,AI 不写具体数字。
|
|
29
|
-
|
|
30
|
-
## 3. 实现步骤
|
|
31
|
-
|
|
32
|
-
1. 第一步做什么(对应哪条口径)
|
|
33
|
-
2. ...
|
|
34
|
-
|
|
35
|
-
## 4. 改动文件白名单
|
|
36
|
-
|
|
37
|
-
- `src/.../Foo.java` — 说明
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
## 前端计划(FRONTEND-PLAN.md)
|
|
41
|
-
|
|
42
|
-
```markdown
|
|
43
|
-
# <需求名> · 前端实现计划
|
|
44
|
-
|
|
45
|
-
## 1. 需求理解
|
|
46
|
-
|
|
47
|
-
用 3 ~ 5 行复述本端要做什么(产品语言)。
|
|
48
|
-
|
|
49
|
-
## 2. 依据与待确认口径
|
|
50
|
-
|
|
51
|
-
### 依据(口径 + 来源)
|
|
52
|
-
|
|
53
|
-
| # | 口径 | 来源 |
|
|
54
|
-
| --- | ---- | ---- |
|
|
55
|
-
| 1 | … | … |
|
|
56
|
-
|
|
57
|
-
### 待确认口径
|
|
58
|
-
|
|
59
|
-
本端有 **N** 项待项目经理确认,详见 [FRONTEND-ASSUMPTIONS.md](./FRONTEND-ASSUMPTIONS.md)。确认前不开始开发。
|
|
60
|
-
|
|
61
|
-
## 3. 实现步骤
|
|
62
|
-
|
|
63
|
-
1. ...
|
|
64
|
-
|
|
65
|
-
## 4. 改动文件白名单
|
|
66
|
-
|
|
67
|
-
- `src/.../Foo.vue` — 说明
|
|
68
|
-
|
|
69
|
-
## 5. 接口对接要点(引用 API.md,禁止复制)
|
|
70
|
-
|
|
71
|
-
- ...
|
|
72
|
-
```
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
## 工作流程
|
|
2
|
-
|
|
3
|
-
### 步骤 1: 获取当前版本 PRD 的内容
|
|
4
|
-
|
|
5
|
-
先用 **Read** 工具阅读 `.apm/sessions/<会话ID>/docs/PRD.md`,如果存在,则这个目录下的内容为需求文档,否则用 **Read** 工具阅读 `.apm/sessions/<会话ID>/TASK.md`,并把这个文件里面的内容视为需求文档
|
|
6
|
-
|
|
7
|
-
### 步骤 2: 按照下面的模板要求编写 PRD
|
|
8
|
-
|
|
9
|
-
用 **Read** 工具阅读 `.apm/skills/apm-write-prd/template.md`,按照模板来写,写完保存到 `.apm/sessions/<会话ID>/docs/PRD.md` 。
|
|
10
|
-
|
|
11
|
-
内容要求如下:
|
|
12
|
-
**不管是第几版需求,都要当成第一版来看,禁止有历史版本或者修订版本或者第几版更新的字样**
|
|
13
|
-
|
|
14
|
-
**可读性**:信息完整保留,但避免整段只靠长句堆砌。对流程分支、状态条件、按钮对照、范围边界等多步骤/多条件内容,按模板中的「图示原则」**适当补充 Mermaid 图或简表**(每个需求点 0 ~ 1 张);图示用于快速扫读,**可验收细节仍以 bullet 为准**,不得因配图而删减文字要求。
|
|
@@ -1,134 +0,0 @@
|
|
|
1
|
-
## 需求模板
|
|
2
|
-
|
|
3
|
-
### 图示原则
|
|
4
|
-
|
|
5
|
-
信息量保持完整,**文字与图示互补**:bullet 写清可验收细节,图示帮助读者快速建立整体印象。优先用 **Mermaid**(Markdown 内嵌,无需额外图片文件)。
|
|
6
|
-
|
|
7
|
-
| 场景 | 推荐图示 | 作用 |
|
|
8
|
-
| ------------------------------------------- | -------------------------------- | -------------------------- |
|
|
9
|
-
| 多步骤操作流程(审批、暂存/提交、办理路径) | `flowchart` | 一眼看清先后与分支 |
|
|
10
|
-
| 字段展示/必填随状态变化 | `flowchart` 或 `stateDiagram-v2` | 替代「当 A 且 B 时…」长句 |
|
|
11
|
-
| 弹窗/页面内区块与按钮布局 | `block-beta` 或 ASCII 框图 | 标出按钮位置与对照关系 |
|
|
12
|
-
| 多需求点关系、范围边界 | `mindmap` 或简表 | 开篇总览,再展开 bullet |
|
|
13
|
-
| 角色与系统交互时序 | `sequenceDiagram` | 仅步骤多、文字难扫读时使用 |
|
|
14
|
-
|
|
15
|
-
**图示写法**:
|
|
16
|
-
|
|
17
|
-
- 每个需求点 **0 ~ 1 张** 图即可;一张图只表达一个核心概念,节点用业务语言(如「一级审批」「暂存」)。
|
|
18
|
-
- 图 **不替代** bullet:图后仍保留 2 ~ 5 条可验收 bullet,图中未写清的细节(文案、边界、校验时机)必须在文字中写明。
|
|
19
|
-
- 图为辅助:若单条 bullet 已足够清楚,**不必强行配图**。
|
|
20
|
-
|
|
21
|
-
### 正文骨架
|
|
22
|
-
|
|
23
|
-
```markdown
|
|
24
|
-
## 背景
|
|
25
|
-
|
|
26
|
-
(1 ~ 3 句:业务背景、要解决的问题、预期效果,如果没有可空着,不要强行编)
|
|
27
|
-
|
|
28
|
-
## 范围
|
|
29
|
-
|
|
30
|
-
- **包含**:…
|
|
31
|
-
- **不包含**:…
|
|
32
|
-
|
|
33
|
-
(可选:范围较大时,用 mindmap 或简表做一页总览)
|
|
34
|
-
|
|
35
|
-
## 需求说明
|
|
36
|
-
|
|
37
|
-
### 需求点 1:[简短名称]
|
|
38
|
-
|
|
39
|
-
(可选:流程/状态/布局类需求,在此放一张 Mermaid 图)
|
|
40
|
-
|
|
41
|
-
- …
|
|
42
|
-
- …
|
|
43
|
-
|
|
44
|
-
### 需求点 2:…
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### 需求点编写规范
|
|
48
|
-
|
|
49
|
-
每条 bullet 写清一个可验收点,优先覆盖:
|
|
50
|
-
|
|
51
|
-
| 类型 | 写法要点 |
|
|
52
|
-
| --------- | ------------------------------------------------------ |
|
|
53
|
-
| 展示/选项 | 展示或隐藏;保留/去掉哪些选项;新建默认值 |
|
|
54
|
-
| 文案 | 原名称 → 新名称;界面、提示、校验文案一并统一 |
|
|
55
|
-
| 按钮 | 场景 + 按钮名 + 行为(对照哪个既有按钮、是否仅改文案) |
|
|
56
|
-
| 校验 | 场景 + 字段展示条件 + 必填时机(暂存 / 提交分别怎样) |
|
|
57
|
-
| 边界 | **不考虑** …(历史数据、迁移、导出等明确排除项) |
|
|
58
|
-
|
|
59
|
-
材料中的技术名可译为业务表述,例如:`audit1` → 一级审批;保存不推进流程 → **暂存**;办理并推进流程 → **提交**。
|
|
60
|
-
|
|
61
|
-
编写示例如下:
|
|
62
|
-
|
|
63
|
-
```markdown
|
|
64
|
-
### 需求点 2:新增/编辑弹窗底部操作
|
|
65
|
-
|
|
66
|
-
- 在**新增、编辑**场景下,弹窗底部新增 **「暂存」** 按钮。
|
|
67
|
-
- **「暂存」**:沿用原 **「确定」** 按钮的业务逻辑(含校验与保存/流程行为),**仅将按钮展示文案改为「暂存」**。
|
|
68
|
-
|
|
69
|
-
### 需求点 3:「科室医德考评小组人员名单」字段
|
|
70
|
-
|
|
71
|
-
(本需求点适合在 bullet 前加「字段展示与校验」流程图,见下方「图示示例」)
|
|
72
|
-
|
|
73
|
-
- 原字段展示名 **「科室医德考评人员名单」** 统一改为 **「科室医德考评小组人员名单」**;凡界面、提示、校验文案等涉及该名称处**一并修改**。
|
|
74
|
-
- 当流程处于 **一级审批** 且该字段**展示**时,须校验为**必填**(在展示场景下触发,而非所有保存入口一律校验)。
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
### 图示示例(按需选用)
|
|
78
|
-
|
|
79
|
-
**字段展示与校验**(对应上文需求点 3):
|
|
80
|
-
|
|
81
|
-
```mermaid
|
|
82
|
-
flowchart LR
|
|
83
|
-
A[进入表单] --> B{流程处于一级审批?}
|
|
84
|
-
B -->|是| C[展示该字段]
|
|
85
|
-
B -->|否| D[按原规则展示/隐藏]
|
|
86
|
-
C --> E{用户操作}
|
|
87
|
-
E -->|暂存或提交| F[校验必填]
|
|
88
|
-
E -->|仅浏览未保存| G[不触发必填校验]
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
**流程分支**(暂存 vs 提交、审批节点):
|
|
92
|
-
|
|
93
|
-
```mermaid
|
|
94
|
-
flowchart TD
|
|
95
|
-
A[用户打开新增/编辑弹窗] --> B[填写表单]
|
|
96
|
-
B --> C{点击底部按钮}
|
|
97
|
-
C -->|暂存| D[沿用原「确定」逻辑:校验 + 保存,不推进流程]
|
|
98
|
-
C -->|提交| E[沿用原「办理」逻辑:校验 + 保存并推进流程]
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
**弹窗底部按钮布局**(对照既有按钮):
|
|
102
|
-
|
|
103
|
-
```text
|
|
104
|
-
┌─────────────────────────────────────┐
|
|
105
|
-
│ 新增 / 编辑弹窗 │
|
|
106
|
-
│ …表单字段… │
|
|
107
|
-
├─────────────────────────────────────┤
|
|
108
|
-
│ [ 取消 ] [ 暂存 ] │ ← 暂存:原「确定」逻辑,仅改文案
|
|
109
|
-
└─────────────────────────────────────┘
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
**范围总览**(需求点较多时,放在「范围」之后):
|
|
113
|
-
|
|
114
|
-
```mermaid
|
|
115
|
-
mindmap
|
|
116
|
-
root((本需求))
|
|
117
|
-
包含
|
|
118
|
-
弹窗底部操作
|
|
119
|
-
字段更名与校验
|
|
120
|
-
不包含
|
|
121
|
-
历史数据迁移
|
|
122
|
-
导出能力
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
### 自检列表
|
|
126
|
-
|
|
127
|
-
- [ ] 含 **背景与目标、范围、需求说明** 三章,叙述完整
|
|
128
|
-
- [ ] 2 分钟内可通读;每个需求点 2 ~ 5 条 bullet,一层列表
|
|
129
|
-
- [ ] 流程/状态/多分支类需求点有 **图示或简表** 辅助,且 bullet 仍覆盖图中未写清的细节
|
|
130
|
-
- [ ] 图示节点使用业务语言,与正文术语一致;无仅看图无法验收的遗漏
|
|
131
|
-
- [ ] 场景、按钮行为、校验时机表述清楚,前后一致
|
|
132
|
-
- [ ] 「范围」与需求点中的 **「不考虑」** 口径一致
|
|
133
|
-
- [ ] 全文使用业务语言,术语统一
|
|
134
|
-
- [ ] 仅材料明确涉及时才有「非功能」「待确认」
|