sdd-flow-kit 1.0.1 → 1.0.3

package/README.md

@@ -15,6 +15,9 @@
 
 1.  进入你要开发的项目目录
 2.  安装：`npm i -D sdd-flow-kit`
+    - 安装后会自动执行一次初始化（postinstall）
+    - 交互终端下会提示选择项目类型（OMS / ADI / 欢盟 / AD Tools，默认 OMS）
+    - 非交互环境自动使用默认值（agent=claude-code, project=OMS）
 3.  安装流程（安装即用，默认 `claude-code`）：`npx sdd-flow-kit install`
     - 会自动安装对应 AI 环境并写入项目级触发 Skill（仅在“开发 <产品> <版本> 需求/版本/PRD”场景触发）
     - 会在项目根目录生成 `docs/<项目>-doc-skill/`（用于 PRD 下载脚本与说明），可通过 `--project` 选择：`OMS` / `ADI` / `欢盟` / `AD Tools`（默认 `OMS`）
@@ -22,6 +25,8 @@
 5.  （可选）环境健检：`npx sdd-flow-kit doctor --agent claude-code`
 6.  完成后，直接在 Cursor / Claude Code / Codex / OpenClaw 中用自然语言发起需求，例如：`开发 ADI 2.3.2 需求`
 
+> 可通过环境变量覆盖安装时默认项目类型：`SDD_FLOW_KIT_PROJECT=ADI npm i -D sdd-flow-kit`
+
 #### 使用说明
 
 1.  `install`（等价 `setup`）：提示选择开发环境（cursor/claude-code/codex/openclaw，默认 claude-code）与开发分支（无则自动创建），并检测/安装 openspec+superpower 基础环境，同时写入项目级 Skill

package/dist/postinstall.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const setupProject_1 = require("./steps/setupProject");
+const ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools"];
+function resolveProjectKindFromEnv() {
+    const raw = (node_process_1.default.env.SDD_FLOW_KIT_PROJECT ?? "").trim();
+    if (ALLOWED_PROJECTS.includes(raw)) {
+        return raw;
+    }
+    return "OMS";
+}
+async function main() {
+    // npm/pnpm 安装依赖时，INIT_CWD 指向用户项目根目录。
+    const initCwd = node_process_1.default.env.INIT_CWD ? node_path_1.default.resolve(node_process_1.default.env.INIT_CWD) : null;
+    const pkgDir = node_path_1.default.resolve(__dirname, "..");
+    const projectRoot = initCwd ?? node_process_1.default.cwd();
+    // 避免在本包自身仓库开发安装依赖时重复触发自动初始化。
+    if (projectRoot === pkgDir)
+        return;
+    const isInteractive = Boolean(node_process_1.default.stdin.isTTY && node_process_1.default.stdout.isTTY);
+    const projectKind = resolveProjectKindFromEnv();
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] postinstall bootstrap at: ${projectRoot}`);
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] interactive=${isInteractive}, defaultProject=${projectKind}`);
+    await (0, setupProject_1.setupProject)({
+        projectRoot,
+        agent: "claude-code",
+        // 交互安装允许用户在 setupProject 内选择 agent/project/branch
+        yes: !isInteractive,
+        dryRun: false,
+        projectKind,
+    });
+    // eslint-disable-next-line no-console
+    console.log("[sdd-flow-kit] setup completed");
+}
+main().catch((err) => {
+    // 不阻断依赖安装，仅告警
+    // eslint-disable-next-line no-console
+    console.warn("[sdd-flow-kit] postinstall setup skipped:", err instanceof Error ? err.message : err);
+});

package/dist/steps/setupProject.js

@@ -160,13 +160,28 @@ function skillInstallPath(projectRoot, agent) {
         return null;
     return node_path_1.default.join(projectRoot, rel);
 }
-async function installAgentSkill(projectRoot, agent) {
-    const target = skillInstallPath(projectRoot, agent);
-    if (!target)
+function allSkillInstallPaths(projectRoot) {
+    const agents = ["cursor", "claude-code", "codex", "openclaw"];
+    return agents
+        .map((agent) => skillInstallPath(projectRoot, agent))
+        .filter((p) => Boolean(p));
+}
+async function installAgentSkill(projectRoot) {
+    const targets = allSkillInstallPaths(projectRoot);
+    if (targets.length === 0)
         return;
     const template = await (0, templates_1.loadTemplateText)("artifacts/06-agent-skill.template.md");
-    const content = template.replaceAll("{{AGENT_NAME}}", agent);
-    await (0, fs_1.writeTextFileEnsuredDir)(target, content);
+    for (const target of targets) {
+        const agentName = target.includes("/.cursor/")
+            ? "cursor"
+            : target.includes("/.claude/")
+                ? "claude-code"
+                : target.includes("/.codex/")
+                    ? "codex"
+                    : "openclaw";
+        const content = template.replaceAll("{{AGENT_NAME}}", agentName);
+        await (0, fs_1.writeTextFileEnsuredDir)(target, content);
+    }
 }
 function renderVars(template, vars) {
     let out = template;
@@ -249,15 +264,14 @@ async function setupProject(options) {
         plannedActions.push("environment already ready, no setup needed");
     }
     if (options.dryRun) {
-        const skillPath = skillInstallPath(options.projectRoot, selectedAgent);
-        if (skillPath) {
+        for (const skillPath of allSkillInstallPaths(options.projectRoot)) {
             plannedActions.push(`would install skill: ${skillPath}`);
         }
         const { dir } = docSkillDirName(selectedKind);
         plannedActions.push(`would install docs skill: ${node_path_1.default.join(options.projectRoot, "docs", dir)}`);
     }
     else {
-        await installAgentSkill(options.projectRoot, selectedAgent);
+        await installAgentSkill(options.projectRoot);
         skillInstalled = true;
         await installDocsSkill(options.projectRoot, selectedKind);
         docsSkillInstalled = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",
@@ -17,7 +17,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "start": "node dist/cli.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "node dist/postinstall.js"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",