ai-project-manage-cli 7.0.2 → 7.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "7.0.2",
+  "version": "7.0.4",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/AGENTS.md

@@ -4,31 +4,40 @@
 
 按任务轻重选择路径：
 
-#### 轻量回复（被 @ 询问、确认、同步进展）
+#### 轻量回信（被 @ 询问、确认、同步进展）
 
 1. 读取 `.apm/rules/reply.md`
-2. **立即**回复（可先简短确认，再补充）
-3. 按需阅读 `.apm/project/` 下的文档，有进展继续回复
+2. **立即**回信（可先简短确认，再补充）
+3. 按需阅读 `.apm/project/` 下的文档，有进展继续回信
 
 #### 重任务（开发、写方案、评审、部署）
 
-1. 按需阅读 `.apm/project/manifest.json` 与相关项目文档
+1. 按需阅读 `.apm/manifest.json` 与相关文档
 2. 根据角色描述完成用户指定的任务
-3. 任务有阶段性进展或者任务完成后必须回复消息（具体见规则 `reply.md`）
-4. 写工作日志（具体见规则 `write_doc.md`）
+3. 任务有阶段性进展或者任务完成后必须回复邮件（回信写法见规则 `reply.md`）
 
-**禁止**在未回复前先读完所有 docs。有进展就先回复。
+**禁止**在未回信前先读完所有 docs。有进展就先回信。
 
 ### 目录指引
 
+- 全局文档索引（`.apm/manifest.json`）
+
+  - 统一索引 `project/`、`rules/`、`skills/` 下的文档
+  - 路径与 manifest 中 `documents[].path` 一一对应，例如：
+    - `project/docs/PRD.md` → `.apm/project/docs/PRD.md`
+    - `rules/reply.md` → `.apm/rules/reply.md`
+    - `skills/apm-write-backend-api/SKILL.md` → `.apm/skills/apm-write-backend-api/SKILL.md`
+
 - 全局文档指引（`.apm/*`）
 
-  - 技能: `.apm/skills/<技能名称>/SKILL.md`，一些常用的工作方法，根据你当前的角色按需阅读
+  - 技能: `.apm/skills/<技能名称>/SKILL.md`，内置技能仅保留：
+    - `apm-write-backend-api`：编写后端计划与 API 文档
+    - `apm-write-checklist`：编写人工回归要点清单
+    - `apm-diff-review`：开发完成后的代码改动评审
   - 规则: `.apm/rules/*`
-    - reply.md：当需要回复消息时需要读取这个文档，记住回复规则
-    - write_doc.md：当需要写文档时需要读取这个文档，记住写文档的规则
+    - reply.md：当需要回复邮件时需要读取这个文档，记住回信写法规则
+    - write_doc.md：当需要向 `.apm/project/` 写入交付文档时阅读（如方案、SQL 变更等）
 
 - 仓库项目上下文（`.apm/project/`）:
-  - 索引: `.apm/project/manifest.json` — 本仓库在平台登记的文档列表
-  - 文档文件: `.apm/project/{path}` — 与 manifest 中 path 对应
+  - 文档文件: `.apm/project/{path}` — 与 manifest 中 `project/{path}` 对应
   - 任务涉及菜单名、路由、业务术语等时，**先 Read manifest 与相关文档**，禁止猜测路径

package/template/apm.config.json

@@ -1,7 +1,7 @@
 {
   "name": "",
   "deploy": {
-    "test": "npm run deploy:test && python .apm/deploy/deploy.py",
-    "online": "npm run deploy:online && python .apm/deploy/deploy.py"
+    "test": "npm run deploy:test",
+    "online": "npm run deploy:online"
   }
-}
+}

package/template/deploy/README.md

@@ -1,15 +1,8 @@
-## 前端部署
-
-部署测试环境： `npm run deploy:test`
-部署线上环境： `npm run deploy:online`
-
-## 后端部署（不区分正式环境和测试环境）
-`python .apm/deploy/deploy.py`
-
 ## 前端产物下载地址
 
 http://<服务器地址>/dist.zip
 http://<服务器地址>/{name}.jar.zip
 
 ## 测试地址
-http://<服务器地址>
+
+http://<服务器地址>

package/template/rules/reply.md

@@ -1,15 +1,15 @@
-## 群内回复规则
+## 回信规则
 
-1. 如果回复的内容包含文档地址，不要把前缀也写出来，直接用文档名称即可。例如: 我已经把待处理的内容更新到了 `PRD.md` 中，请查阅。
-2. 回复的内容并非对你工作的总结，要尽可能简洁，不要长篇大论，如果同步的内容确实较多，你可以先写文档，然后指引用户去阅读你写的文档。
-3. 只要你有任何进展都可以调用下面的命令进行回复，你可以一直补充内容。**被 @ 提及时，收到后必须先回复一句简短确认（不超过 50 字），再开始读文档或执行任务。**
-4. 如果有需要指定相关人，必须在消息内容中@指定出来
+1. 如果回信的内容包含文档地址，不要把前缀也写出来，直接用文档名称即可。例如: 我已经把待处理的内容更新到了 `PRD.md` 中，请查阅。
+2. 回信的内容并非对你工作的总结，要尽可能简洁，不要长篇大论，如果同步的内容确实较多，你可以先写文档，然后指引对方去阅读你写的文档。
+3. 只要你有任何进展都可以调用下面的工具进行回信，你可以一直补充内容。**被 @ 提及时，收到后必须先回信一句简短确认（不超过 50 字），再开始读文档或执行任务。**
+4. 如果有需要指定相关人，必须在回信内容中 @ 指定出来
 
-## 执行回复的方法
+## 执行回信的方法
 
-调用 `append_message` 工具，`content` 传入你要回复的消息内容。可多次调用补充进展。
+调用 `append_mail_reply` 工具，`content` 传入你要回复的邮件内容。可多次调用补充进展。Agent 正常结束后会自动提交完整回信。
 
-示例: `append_message(content="收到，正在分析后端改动范围。")`
+示例: `append_mail_reply(content="收到，正在分析后端改动范围。")`
 
 ## 写文档的方法
 

package/template/rules/write_doc.md

@@ -1,16 +1,4 @@
-## 写工作日志
-
-命名方式： <你的名字>-工作日志.md
-保存位置: `.apm/project/docs/<文件名>`
-日志格式：见如下 markdown 中间的内容
-
-```markdown
-## <简要总结本轮干了什么>
-
-<内容>
-```
-
-## 写其他文件
+## 写交付文档
 
 命名方式: <你的名字>-<主题>.md
 保存位置: `.apm/project/docs/<文件名>`
@@ -20,7 +8,7 @@
 
 固定文件名: `SQL.md`
 保存位置: `.apm/project/docs/SQL.md`
-适用场景: 后端开发涉及 SQL 改动（DDL/DML、表结构、Mapper/XML 中 SQL 等）时必须产出或追加更新，详见 `.apm/skills/apm-dev/SKILL.md` 中「后端 SQL 变更文档」章节。
+适用场景: 后端开发涉及 SQL 改动（DDL/DML、表结构、Mapper/XML 中 SQL 等）时必须产出或追加更新。
 格式要求:
 
 - 须标注**目标数据库**（库名/实例名、类型如 MySQL；同一变更涉及多库时分别标注）

package/template/skills/apm-diff-review/SKILL.md

@@ -18,11 +18,11 @@
 
 ### 步骤 2：四项检查
 
-| 检查项         | 判定                                                                                                                                                                            |
-| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **白名单对账** | diff 中出现白名单之外的文件，且计划未更新说明 → **不通过**                                                                                                                      |
-| **需求相关性** | 存在与本需求无关的改动（顺手重构、改格式、动了无关逻辑）→ **不通过**                                                                                                            |
-| **计划落实**   | 计划「实现步骤」中的关键点在 diff 中找不到对应实现 → **不通过**                                                                                                                 |
+| 检查项         | 判定                                                                                                                                                                                         |
+| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **白名单对账** | diff 中出现白名单之外的文件，且计划未更新说明 → **不通过**                                                                                                                                   |
+| **需求相关性** | 存在与本需求无关的改动（顺手重构、改格式、动了无关逻辑）→ **不通过**                                                                                                                         |
+| **计划落实**   | 计划「实现步骤」中的关键点在 diff 中找不到对应实现 → **不通过**                                                                                                                              |
 | **SQL 文档**   | **仅后端**：diff 涉及 SQL 改动（DDL/DML、表结构、Mapper/XML 中 SQL 等），但 `.apm/project/docs/SQL.md` 缺失、未标注目标数据库、与改动不一致、或 SQL 代码块含 `...`/「省略」占位 → **不通过** |
 
 注意事项：
@@ -48,7 +48,7 @@ apm create-pr --title "<需求摘要>" --content "<计划摘要 + 白名单对
 
 1. 「diff 评审通过」+ 一句话改动概述；
 2. **PR 链接**（上一步 `apm create-pr` 输出；创建失败则注明原因）；
-3. 测试环境地址（从开发的回复或工作日志中获取）；
+3. 测试环境地址（从开发的回信或相关文档中获取）；
 4. 提示按 `CHECKLIST.md` 逐条验收。
 
 **不通过**：用 `append_message` 输出问题清单（每条注明文件 + 问题 + 依据哪条计划/需求），`@` 对应工程师打回修改。**禁止自己动手改。**