npm - ai-project-manage-cli - Versions diffs - 1.0.18 → 1.0.19 - Mend

ai-project-manage-cli 1.0.18 → 1.0.19

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 (8) hide show

package/dist/cli/commands/init.d.ts.map +1 -1
package/dist/cli/commands/init.js +86 -1
package/dist/cli/commands/init.js.map +1 -1
package/package.json +1 -1
package/templates/skills/apm-auto-dev/SKILL.md +5 -5
package/templates/skills/bug-fix/SKILL.md +4 -4
package/templates/skills/test-env-release/SKILL.md +31 -0
package/templates/skills/frontend-test-env-release/SKILL.md +0 -81

package/dist/cli/commands/init.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;~~AAmCzC~~,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,~~CAyC3D~~"}
1	+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkIzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD3D"}

package/dist/cli/commands/init.js CHANGED Viewed

@@ -6,10 +6,88 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerInitCommands = registerInitCommands;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
+const DEPLOY_README_STUB = `# 测试环境部署说明
+请在本文件中编写：前置条件、构建命令、部署命令、验证方式等。Agent / \`apm\` 将按本文档执行测试环境部署。
+## 前置条件
+（可选）
+## 部署步骤
+1.
+## 验证
+（可选）
+`;
+const PRODUCT_CAPABILITY_README_STUB = `# 产品能力清单
+本目录用于维护产品能力条目（CAP）。详见 [使用说明书.md](./使用说明书.md)。
+## 子系统列表
+| 目录 | 说明 |
+|------|------|
+| （待补充） | 在各子目录下维护 \`index.md\` 与 \`CAP-*.md\` |
+`;
 function resolveSkillSourceDir() {
     // dist/cli/commands/init.js -> ../../../templates/skills
     return node_path_1.default.resolve(__dirname, "../../../templates/skills");
 }
+async function pathExists(p) {
+    try {
+        await (0, promises_1.stat)(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** \`.cursor/skills\` 所在仓库根目录 */
+function resolveProjectRootFromCursorSkillsDir(cursorSkillsDir) {
+    return node_path_1.default.resolve(cursorSkillsDir, "..", "..");
+}
+/**
+ * 创建标准 \`.apm\` 目录结构（与仓库内参考 \`.apm\` 一致）：
+ * - workitems
+ * - deploy（含占位 README，已存在则不覆盖）
+ * - product-capability-inventory（含总览 README；从模板复制使用说明书，已存在则不覆盖）
+ */
+async function ensureApmStandardLayout(projectRoot, skillsTemplateDir) {
+    const apmRoot = node_path_1.default.join(projectRoot, ".apm");
+    const created = [];
+    const warnings = [];
+    await (0, promises_1.mkdir)(node_path_1.default.join(apmRoot, "workitems"), { recursive: true });
+    created.push(".apm/workitems");
+    await (0, promises_1.mkdir)(node_path_1.default.join(apmRoot, "deploy"), { recursive: true });
+    created.push(".apm/deploy");
+    await (0, promises_1.mkdir)(node_path_1.default.join(apmRoot, "product-capability-inventory"), { recursive: true });
+    created.push(".apm/product-capability-inventory");
+    const deployReadme = node_path_1.default.join(apmRoot, "deploy", "README.md");
+    if (!(await pathExists(deployReadme))) {
+        await (0, promises_1.writeFile)(deployReadme, DEPLOY_README_STUB, "utf8");
+        created.push(".apm/deploy/README.md");
+    }
+    const manualSrc = node_path_1.default.join(skillsTemplateDir, "product-capability-inventory", "使用说明书.md");
+    const manualDst = node_path_1.default.join(apmRoot, "product-capability-inventory", "使用说明书.md");
+    if (!(await pathExists(manualDst))) {
+        if (await pathExists(manualSrc)) {
+            await (0, promises_1.cp)(manualSrc, manualDst);
+            created.push(".apm/product-capability-inventory/使用说明书.md");
+        }
+        else {
+            warnings.push(`模板缺失，未复制使用说明书: ${manualSrc}`);
+        }
+    }
+    const capReadme = node_path_1.default.join(apmRoot, "product-capability-inventory", "README.md");
+    if (!(await pathExists(capReadme))) {
+        await (0, promises_1.writeFile)(capReadme, PRODUCT_CAPABILITY_README_STUB, "utf8");
+        created.push(".apm/product-capability-inventory/README.md");
+    }
+    return { apmRoot, created, warnings };
+}
 async function resolveCursorSkillsDir() {
     // 从当前工作目录向上查找最近的 `.cursor/skills`
     let cur = process.cwd();
@@ -39,10 +117,12 @@ async function resolveCursorSkillsDir() {
 function registerInitCommands(program) {
     program
         .command("init")
-        .description("安装内置 Cursor skills 到当前项目的 .cursor/skills（须已存在该目录）")
+        .description("安装内置 Cursor skills 到当前项目的 .cursor/skills（须已存在该目录），并初始化标准 .apm 目录结构")
         .action(async () => {
         const srcDir = resolveSkillSourceDir();
         const dstDir = await resolveCursorSkillsDir();
+        const projectRoot = resolveProjectRootFromCursorSkillsDir(dstDir);
+        const apmResult = await ensureApmStandardLayout(projectRoot, srcDir);
         await (0, promises_1.mkdir)(dstDir, { recursive: true });
         // 读取模板下的技能子目录名，用于在目标目录中做“删除后重装”
         const entries = await (0, promises_1.readdir)(srcDir, { withFileTypes: true });
@@ -64,6 +144,11 @@ function registerInitCommands(program) {
             ok: true,
             installedFrom: srcDir,
             installedTo: dstDir,
+            apm: {
+                root: apmResult.apmRoot,
+                created: apmResult.created,
+                warnings: apmResult.warnings,
+            },
         }, null, 2));
     });
 }

package/dist/cli/commands/init.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":";;;;;~~AAqCA~~,~~oDAyCC~~;~~AA9ED~~,+~~CAAgE~~;~~AAChE~~,0DAA6B;AAG7B,SAAS,qBAAqB;IAC5B,yDAAyD;IACzD,OAAO,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,sBAAsB;IACnC,kCAAkC;IAClC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,qBAAqB;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAA,eAAI,EAAC,SAAS,CAAC,CAAC;YAChC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,gCAAgC;IAChC,sCAAsC;IACtC,sCAAsC;IACtC,OAAO,CAAC,KAAK,CACX,iEAAiE,CAClE,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,~~mDAAmD~~,~~CACpD~~;SACA,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,sBAAsB,EAAE,CAAC;~~QAE9C~~,MAAM,IAAA,gBAAK,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,gCAAgC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAE5E,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,IAAA,aAAE,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QACD,MAAM,IAAA,aAAE,EAAC,MAAM,EAAE,MAAM,EAAE;YACvB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,EAAE,EAAE,IAAI;YACR,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,MAAM;~~SACpB~~,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}
1	+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "private": false,
   "description": "CLI / SDK for AI项目管理",
   "main": "./dist/index.js",

package/templates/skills/apm-auto-dev/SKILL.md CHANGED Viewed

@@ -120,13 +120,13 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status IN_DEVELOPMEN
 ---
-## 步骤 8 — 子 Agent：调用 `frontend-test-env-release` 发布前端测试环境
+## 步骤 8 — 子 Agent：调用 `test-env-release` 部署测试环境
 1. 本步骤必须在“全部代码提交完成”后执行（即步骤 7 完成后）。
-2. 调用技能 `frontend-test-env-release`，执行前端测试环境发布（构建 + 上传产物）。
-3. **若发布失败**：必须输出失败原因并记录；**不得因此跳过或终止步骤 9**（仍须继续执行「待测试」状态更新）。
+2. 调用技能 `test-env-release`，按项目根目录 `.apm/deploy/README.md` 部署测试环境。
+3. **若部署失败**：必须输出失败原因并记录；**不得因此跳过或终止步骤 9**（仍须继续执行「待测试」状态更新）。
-**完成判定（本步骤自身）**：发布成功为理想结果；发布失败亦视为本步骤已结束（带失败信息），并进入步骤 9。
+**完成判定（本步骤自身）**：部署成功为理想结果；部署失败亦视为本步骤已结束（带失败信息），并进入步骤 9。
 ---
@@ -152,7 +152,7 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status PENDING_TEST
 - 分支名、`.apm/workitems/<name>/` 路径、`openspec/changes/<change-name>/`
 - 各子步骤成功/失败
-- 步骤 8 前端测试环境发布结果（成功或失败原因；失败不阻断步骤 9）
+- 步骤 8 测试环境部署结果（成功或失败原因；失败不阻断步骤 9）
 - 步骤 9 分支是否已置为「待测试」
 - 最终 commit SHA（若有）、远程推送结果
 - 若有 stash：提醒用户在其他分支上 `git stash pop` 时注意冲突

package/templates/skills/bug-fix/SKILL.md CHANGED Viewed

@@ -128,13 +128,13 @@ apm requirement defect set-status --defect-id <defectId> --status RESOLVED
 **完成判定**：未提供 `defectId` 时本步骤被正确跳过；提供 `defectId` 时 CLI 返回成功且缺陷状态为 `RESOLVED`。
-### 步骤 8 — 子 Agent：调用 `frontend-test-env-release` 发布前端测试环境
+### 步骤 8 — 子 Agent：调用 `test-env-release` 部署测试环境
 1. 本步骤必须在“全部代码提交完成”后执行（至少已完成步骤 4；若有推送要求则需先完成步骤 6）。
-2. 调用技能 `frontend-test-env-release`，执行前端测试环境发布流程（构建 + 上传产物）。
-3. 若发布失败，输出失败原因并将流程标记为失败，不得宣称 bug-fix 全流程完成。
+2. 调用技能 `test-env-release`，按项目根目录 `.apm/deploy/README.md` 部署测试环境。
+3. 若部署失败，输出失败原因并将流程标记为失败，不得宣称 bug-fix 全流程完成。
-**完成判定**：`frontend-test-env-release` 执行成功，前端测试环境发布完成。
+**完成判定**：`test-env-release` 执行成功，测试环境部署完成。
 ## 约束

package/templates/skills/test-env-release/SKILL.md ADDED Viewed

@@ -0,0 +1,31 @@
+---
+name: test-env-release
+description: 部署测试环境。必须先阅读项目根目录下的 `.apm/deploy/README.md` 并按文档执行（文档不存在则终止，不猜测命令）。Use when 用户提到「部署测试环境」「测试环境部署」「发布测试环境」等与测试环境部署相关诉求。
+---
+# 部署测试环境
+## 目标
+在目标项目根目录完成一次**可复现**的测试环境部署。所有具体命令、前置条件、校验方式**以项目内文档为准**，本技能不替代该文档。
+## 唯一权威：`.apm/deploy/README.md`
+1. **执行任何部署命令之前**，必须先使用 Read 工具阅读**项目根目录**下的：
+   `.apm/deploy/README.md`
+2. **若该文件不存在或无法读取**：立即终止，明确告知用户需在项目根目录补充 `.apm/deploy/README.md` 部署说明；**不要**用 README、package.json 或其它文件猜测部署方式。
+3. **严格按文档步骤执行**：文档中写明的命令、目录、环境变量、顺序即为执行依据；文档未提及的操作不要自行发明。
+4. 若文档要求先构建再发布/上传等：仅在文档允许的前提下，再参考文档中指向的其它路径（例如某子目录 README）；仍**不得**绕过 `.apm/deploy/README.md` 中已写明的流程。
+## 失败处理
+- 文档缺失或步骤无法执行：终止并说明缺少什么或哪一步失败。
+- 某一步命令非 0 退出：按文档是否有「失败时」说明处理；若无，则终止并输出错误信息，不静默重试无关命令。
+## 成功判定
+以 `.apm/deploy/README.md` 中定义的「完成」或「验证」为准（例如健康检查、访问地址、接口返回等）。文档未写成功条件时，以文档列出的最后一步无错误执行完毕为准。

package/templates/skills/frontend-test-env-release/SKILL.md DELETED Viewed

@@ -1,81 +0,0 @@
----
-name: frontend-test-env-release
-description: 执行客户端前端产物发布：先从 README 识别构建方式（找不到立即终止，不猜测），再自动识别分支名与产物目录并调用 apm publish 上传。Use when 用户提到“上传产物/发布前端产物/minio 上传/一键发布客户端前端”。
----
-# 发布测试环境
-## 目标
-在客户端机器执行一次可中断、可复现的发布流程：
-1. 根据项目文档识别并执行构建命令（找不到构建方式立即终止，不猜测）
-2. 自动识别分支名和产物目录后上传到服务端
-## 输入
-- 项目根目录（默认当前目录）
-- 可选：用户手动指定产物目录（若提供则优先使用）
-## 执行流程
-### 1) 构建（找不到构建方式即终止，不猜测）
-1. 先阅读目标项目根目录下的 `README.md`，识别该项目推荐的构建方式：
-   - 优先使用 README 中明确写出的构建命令（如 `rush build`、`rushx build`、`pnpm build`、`npm run build` 等）。
-   - 若 README 中包含“在某子目录执行构建”的说明，需先进入对应子目录再执行。
-   - 若 README 未提供可执行的构建命令：立即终止并提示“未在 README.md 中找到构建方式，请补充文档”；不要猜测或兜底尝试 `npm run build`、`pnpm build` 等命令。
-2. 在识别到的目录执行识别到的构建命令（不要写死 `npm run build`）：
-```bash
-<build-command-from-readme>
-```
-3. 若退出码非 0：立即终止，不执行上传步骤，并输出失败原因。
-### 2) 自动识别并上传
-#### 2.1 识别分支名
-1. 获取当前分支：
-```bash
-git rev-parse --abbrev-ref HEAD
-```
-2. 取最后一段作为上传分支名：
-   - `feat/login` -> `login`
-   - `feature/a/b` -> `b`
-#### 2.2 识别产物目录名
-按以下优先级选择目录（命中即停止）：
-1. 用户显式提供的目录（如 `dist`）
-2. 当前项目根目录下已存在且非空的：`dist`
-3. 当前项目根目录下已存在且非空的：`build`
-4. 当前项目根目录下已存在且非空的：`out`
-5. 若以上均不存在：终止并报错“未找到构建产物目录”
-#### 2.3 上传
-使用识别结果执行：
-```bash
-apm publish --branch-name "<branchLastSegment>" --dir "<artifactDir>"
-```
-## 成功判定
-- README 指定的构建命令执行成功
-- `apm publish` 成功返回 `ok: true`
-- MinIO 目录满足：`<branchLastSegment>/<artifactDir>/...`
-## 失败处理
-- 构建失败：直接结束，不进入上传
-- 分支识别失败：直接结束并提示检查 git 仓库状态
-- 目录识别失败：直接结束并提示显式传入目录
-- 上传失败：输出接口错误并结束