ai-project-manage-cli 5.0.13 → 5.0.14

package/package.json

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

package/template/AGENTS.md

@@ -17,7 +17,8 @@
 1. 读取 `.apm/sessions/<会话ID>/session.yaml`，必要时读取`messages.xml` 了解当前会话状态与历史消息
 2. 根据你的名字从 session.yaml 中找到你对应的人设(system_persona)
 3. 根据人设完成用户指定的任务
-4. 任务有阶段行进展或者任务完成后必须使用 `apm append-message` 回复消息
+4. 任务有阶段行进展或者任务完成后必须使用 `apm append-message` 回复消息，回复要求简洁不用对本轮工作进行总结
+5. 工作日志放到 `.apm/sessions/<会话ID>/docs/<position>.md` 中，并执行`apm sync-document <会话ID> --file=<position>`同步到远程
 
 ## 目录声明
 

package/template/skills/apm-dev/SKILL.md

@@ -1,28 +1,27 @@
 ## 工作流程
+
 1. 选择开发模式：**Quick/Spec**
 
-**Quick 开发**（满足越多越适用）: 
-    - 影响范围局部：少量文件或单一层次（例如仅前端组件、或仅一个后端模块小改）。
-    - 无新表结构/大规模迁移/权限模型变更。
-    - PRD 验收点清晰且数量少（经验上 **≤3** 条独立验收维度）。
-    - 不需要跨多服务的架构裁定即可开工。
-**Spec 开发**：（命中任一条即可）：
-    - 前后端联动、多包改造或新公共抽象。
-    - 新数据模型、迁移、或安全/审计/权限相关。
-    - PRD 范围大、条款多，或存在明显「待确认/多方案」需先规划。
-    - 评估认为不先产出 **proposal / design / specs / 
+**Quick 开发**（满足越多越适用）: - 影响范围局部：少量文件或单一层次（例如仅前端组件、或仅一个后端模块小改）。 - 无新表结构/大规模迁移/权限模型变更。 - PRD 验收点清晰且数量少（经验上 **≤3** 条独立验收维度）。 - 不需要跨多服务的架构裁定即可开工。
+**Spec 开发**：（命中任一条即可）： - 前后端联动、多包改造或新公共抽象。 - 新数据模型、迁移、或安全/审计/权限相关。 - PRD 范围大、条款多，或存在明显「待确认/多方案」需先规划。 - 评估认为不先产出 **proposal / design / specs / tasks** 不宜直接编码。
 
-2. 如果为 **Quick 开发**（子Agent中）执行：
+2. 如果为 **Quick 开发**（子 Agent 中）执行：
 
-+ 父 Agent 已通过 **Read** 掌握 `PRD.md`；若启动新子 Agent，在委派提示中写明会话ID、消息ID、工作项路径、以及「实现须严格对照 PRD，改动范围最小化」。
-+ 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
-    - 按需 **Read** `.apm/sessions/<会话ID>/docs/PRD.md`
-    - 按 PRD 直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
-    - 完成后在返回中说明：改了哪些路径、如何对照验收、是否通过本地可执行的检查（若子 Agent 跑了 `rushx build` / 测试等则写明结果）。
+- 父 Agent 已通过 **Read** 掌握 `PRD.md`；若启动新子 Agent，在委派提示中写明会话 ID、消息 ID、工作项路径、以及「实现须严格对照 PRD，改动范围最小化；完成后若有代码改动须单独 `git commit`」。
+- 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
+  - 按需 **Read** `.apm/sessions/<会话ID>/docs/PRD.md`
+  - 按 PRD 直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
+  - **Git**：实现与自洽验收通过后，若有代码改动，**立即 `git add` + `git commit` 一次**（Quick 通常为单次交付，**一次实现 = 一个 commit**；勿拆成无意义碎 commit）。提交信息建议包含 `seesionId`（可从 `session.yaml` 或 PRD 获取）与 PRD 摘要或验收点简述。
+  - 完成后在返回中说明：改了哪些路径、如何对照验收、是否通过本地可执行的检查（若子 Agent 跑了 `rushx build` / 测试等则写明结果）；若有 commit，写明 **short-sha** 与 **subject**，无代码改动则注明跳过 commit。
 
-3. 如果为  **Spec 开发** （子Agent中）执行：
+3. 如果为 **Spec 开发** （子 Agent 中）执行：
 
 - 父 Agent **Read** **apm-propose**、**apm-apply-change** 的 `SKILL.md`（**仅** `.apm/skills/` 下路径，见上节）。
 - **子 Agent A（规划）**：Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-propose/SKILL.md` 并完整遵循：在 `.apm/sessions/<sessionId>/` 生成 **proposal、design、specs、tasks** 等工件（顺序与依赖以 SKILL 为准）。
 - **子 Agent B（实现）**：待 A 成功落盘后，再 Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-apply-change/SKILL.md` 并完整遵循：按 **`tasks.md`** 驱动实现与勾选；遵守该技能中的停止条件与 commit 约定。
 - 若 **apm-propose** 未产出可用 **`tasks.md`**，不得强行进入 **apm-apply-change**；表格中标记阻塞原因。
+
+4. 提交并 push 代码
+
+- Quick / Spec 子 Agent 完成且本地已有 commit 时，父 Agent **立即 `git push`**（当前分支首次 push 用 `git push -u origin HEAD`）。
+- 无本地 commit、无远程或未配置 upstream 时说明原因，勿强行 push。