@andyqiu/codeforge 0.3.13 → 0.3.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andyqiu/codeforge",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,
@@ -27,6 +27,7 @@
     "access": "public"
   },
   "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs",
     "prebuild": "node ./scripts/check-bun.mjs",
     "build": "node ./scripts/build-with-version.mjs",
     "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly",
@@ -123,6 +124,7 @@
     "scripts/check-bun.mjs",
     "scripts/merge-agents-md.mjs",
     "scripts/sync-agent-models.mjs",
+    "scripts/postinstall.mjs",
     "schemas/",
     "install.sh",
     "install.ps1",

package/scripts/postinstall.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * scripts/postinstall.mjs — npm postinstall 自动全局安装入口
+ *
+ * 设计意图（ADR: npm-postinstall-auto-global）：
+ *   - npm install -g @andyqiu/codeforge 完成后自动等效 `codeforge install --global`
+ *   - 本地 install / devDep install / pnpm·yarn·bun 全局安装 → fail-closed 不触发
+ *   - 任何失败均 exit 0，绝不阻断包管理器主流程
+ *
+ * 包管理器矩阵（详见 ADR Decision 段）：
+ *   npm  -g  ✅  唯一保证注入 npm_config_global=true 的包管理器 → 触发安装
+ *   pnpm     ❌  v11+ 官方声明不传递 npm_config_*；fail-closed + stderr 提示
+ *   yarn     ❌  classic/berry 均不传递 npm_config_*；fail-closed + stderr 提示
+ *   bun      ❌  行为未文档化；fail-closed + stderr 提示
+ *   unknown  ❌  无 user_agent 信号；静默 exit 0
+ *
+ * 短路条件（任一命中即静默 exit 0）：
+ *   - CODEFORGE_SKIP_POSTINSTALL=1   用户/CI 显式禁用
+ *   - CI=true 且未设 CODEFORGE_POSTINSTALL_IN_CI=1   避免污染 CI ~/.config
+ *   - 未支持的 process.platform（仅 linux/darwin/win32 通过）
+ */
+
+import { spawnSync } from "node:child_process"
+import * as path from "node:path"
+import * as url from "node:url"
+
+const __filename = url.fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const REPO_ROOT = path.resolve(__dirname, "..")
+
+// ────────────────────────────────────────────────────────────────────
+// 工具函数
+// ────────────────────────────────────────────────────────────────────
+
+/**
+ * 解析 npm_config_user_agent，识别包管理器。
+ * 所有主流包管理器都设此变量，格式形如：
+ *   "npm/10.0.0 node/v20.0.0 linux x64 workspaces/false"
+ *   "pnpm/9.0.0 npm/? node/v20.0.0 linux x64"
+ *   "yarn/1.22.0 npm/? node/v18.0.0 linux x64"
+ *   "bun/1.0.0 npm/? node/v20.0.0 linux x64"
+ */
+function detectPackageManager() {
+  const ua = process.env.npm_config_user_agent || ""
+  if (ua.startsWith("npm/")) return "npm"
+  if (ua.startsWith("pnpm/")) return "pnpm"
+  if (ua.startsWith("yarn/")) return "yarn"
+  if (ua.startsWith("bun/")) return "bun"
+  return "unknown"
+}
+
+function warn(msg) {
+  // 写 stderr 避免污染期望干净 stdout 的脚本
+  process.stderr.write(`[codeforge postinstall] ${msg}\n`)
+}
+
+function exitOk(reason) {
+  // 调试/测试可读：CODEFORGE_POSTINSTALL_DEBUG=1 时打印短路原因到 stderr
+  if (process.env.CODEFORGE_POSTINSTALL_DEBUG === "1") {
+    process.stderr.write(`[codeforge postinstall] skip: ${reason}\n`)
+  }
+  process.exit(0)
+}
+
+// ────────────────────────────────────────────────────────────────────
+// 主流程（全局 try/catch 兜底，任何异常 → exit 0）
+// ────────────────────────────────────────────────────────────────────
+
+try {
+  // ── 短路 S1: 用户/CI 显式禁用 ──
+  if (process.env.CODEFORGE_SKIP_POSTINSTALL === "1") {
+    exitOk("CODEFORGE_SKIP_POSTINSTALL=1")
+  }
+
+  // ── 短路 S2: CI 环境默认跳过 ──
+  if (process.env.CI === "true" && process.env.CODEFORGE_POSTINSTALL_IN_CI !== "1") {
+    exitOk("CI=true (set CODEFORGE_POSTINSTALL_IN_CI=1 to opt in)")
+  }
+
+  // ── 短路 S3: 未支持平台 ──
+  const supportedPlatforms = ["linux", "darwin", "win32"]
+  if (!supportedPlatforms.includes(process.platform)) {
+    exitOk(`unsupported platform: ${process.platform}`)
+  }
+
+  // ── 主决策 ──
+  const pm = detectPackageManager()
+  const isGlobal = process.env.npm_config_global === "true"
+
+  // D1: npm + global → 触发安装
+  if (pm === "npm" && isGlobal) {
+    const cli = path.join(REPO_ROOT, "bin", "codeforge.mjs")
+    const args = [cli, "install", "--global", "--skip-build"]
+    const env = { ...process.env, CODEFORGE_FROM_POSTINSTALL: "1" }
+    const r = spawnSync(process.execPath, args, {
+      stdio: "inherit",
+      env,
+    })
+    if (r.status !== 0) {
+      warn(
+        `自动全局安装失败（exit code ${r.status ?? "unknown"}）。` +
+          `请手动执行：codeforge install --global`,
+      )
+    }
+    // 无论成功失败，都 exit 0，不阻断 npm
+    process.exit(0)
+  }
+
+  // D2: 识别为 pnpm/yarn/bun → fail-closed + 用户可见提示
+  if (pm === "pnpm" || pm === "yarn" || pm === "bun") {
+    warn(
+      `检测到使用 ${pm}，无法自动确定是否为全局安装；` +
+        `如果你刚才跑的是 \`${pm} global add\` / \`add -g\`，` +
+        `请手动执行：codeforge install --global`,
+    )
+    process.exit(0)
+  }
+
+  // D3: 其它（npm 但非 global / unknown pm / 无 user_agent）→ 静默 exit 0
+  exitOk(`no-op (pm=${pm}, global=${isGlobal})`)
+} catch (e) {
+  // 任何未捕获异常都不向 npm 抛错
+  warn(`unexpected error: ${e && e.message ? e.message : String(e)}`)
+  process.exit(0)
+}

package/skills/weighted-dimensions/SKILL.md

@@ -100,9 +100,16 @@ weighted_score = 0.8×0.30 + 0.5×0.25 + 0.3×0.20 + 0.6×0.15 + 0.2×0.10
 
 **Functional 常见打分依据**：
 - 0.0：只说了"做个东西"，完全不知道做什么
+- 0.2：有隐约方向但目标群体/核心输出不明（如"做个管理工具"）
+- 0.4：目标群体 + 核心使用场景已清晰，但核心功能边界还未明确（如"给老板看指标的看板"，知道谁用/做什么，但不知道哪些指标/什么展示形式）
 - 0.5：知道大方向（"做个导出"），但不知道输出形式、流程
 - 1.0：输入输出明确，核心流程可描述，用户能说出 Job
 
+> **初轮信息密度校准**（方案 A 补充）：Phase A 初轮评分反映的是**信息密度**，不是需求质量高低。
+> 用户首轮说出「目标群体 + 核心 Job」即可给 0.4，不要因为细节不足降到 0.2。
+> 0.2 应保留给真正「只有一个动词、连做什么都不清楚」的极端情形。
+> 典型校准案例：「做看板让老板看指标」= 目标群体（老板）+ 核心输出（看板/指标）已给出 → Functional ≥ 0.4。
+
 **Edge Cases 常见打分依据**：
 - 0.0：完全没讨论过边界
 - 0.5：讨论了 1-2 个正常 happy path，无异常路径