@house365/comate 0.1.1 → 0.1.3

package/README.md

@@ -25,12 +25,20 @@ open → design → build → verify → archive
 ## 安装
 
 ```bash
-npx @house365/comate init     # 装 comate + 依赖到当前项目 ./.agents/skills/
-npx @house365/comate init -g  # 装到用户全局
+cd <你的项目目录>
+npx @house365/comate init     # 装到 ./.agents/skills/
+```
+
+装到用户全局，所有项目可用（此时在哪个目录执行都一样）：
+
+```bash
+npx @house365/comate init -g  # 装到 ~/.agents/skills/
 ```
 
 `init` 会一并装齐两个依赖（OpenSpec CLI、Superpowers），已装的自动跳过，可重复执行。
 
+项目安装的目标目录就是**你执行命令时所在的目录**。init 会先打印完整路径，并在目录看起来不像项目（没有 `.git`、`package.json` 等标志）或就是你的主目录时中止，避免装错地方——确实要装在当前目录就加 `--force`。
+
 只装 comate 本身、不碰依赖：
 
 ```bash

package/bin/cli.mjs

@@ -20,10 +20,12 @@ if (args[0] === '--help' || args[0] === '-h') {
   console.log(`comate — OpenSpec + Superpowers 规约驱动的开发编排器
 
 用法:
-  comate-skills init [-g] [--openspec-init]
+  comate-skills init [-g] [--openspec-init] [--force]
       安装 comate 及依赖 (OpenSpec CLI、Superpowers)。已装的自动跳过，可重复执行。
+      项目安装装到当前目录，执行前会打印完整路径并确认这像个项目目录。
         -g, --global      安装到用户全局目录 (默认: 当前项目)
         --openspec-init   同时运行 openspec init 创建项目结构
+        -f, --force       跳过目录检查，就装在当前目录
 
   comate-skills [add|list|remove|update ...]
       直接透传给 skills CLI。不带子命令时安装本包全部 skill。

package/bin/init-run.mjs

@@ -1,5 +1,6 @@
 // The `init` flow: pick a scope, then install what's missing.
 import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
 
 import {
   MIN_OPENSPEC,
@@ -18,12 +19,67 @@ export function resolveScope(argv) {
   return argv.includes('-g') || argv.includes('--global') ? 'global' : 'project';
 }
 
+// A project install lands in cwd, and `npx` runs wherever the user happens to
+// be — so cwd is a guess, not a decision. Report it, and refuse the two cases
+// that are almost certainly a mistake: the home directory (that's what -g is
+// for) and a directory with no project marker at all.
+const PROJECT_MARKERS = [
+  '.git',
+  'package.json',
+  'pyproject.toml',
+  'Cargo.toml',
+  'go.mod',
+  'pom.xml',
+  'build.gradle',
+  'composer.json',
+  'Gemfile',
+  'openspec',
+  '.agents',
+];
+
+export function inspectTarget(dir, home) {
+  const normalise = (p) => resolve(p).replace(/[\\/]+$/, '').toLowerCase();
+  if (home && normalise(dir) === normalise(home)) return { kind: 'home' };
+  const marker = PROJECT_MARKERS.find((m) => existsSync(join(dir, m)));
+  return marker ? { kind: 'project', marker } : { kind: 'bare' };
+}
+
 export async function init(pkgRoot, argv) {
   const scope = resolveScope(argv);
   const withOpenSpecInit = argv.includes('--openspec-init');
+  const force = argv.includes('-f') || argv.includes('--force');
   const results = [];
 
-  console.log(`\n安装范围: ${scope === 'global' ? '全局' : '项目'}\n`);
+  const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
+  if (scope === 'global') {
+    console.log(`\n安装范围: 全局 -> ${join(home, '.agents', 'skills')}\n`);
+  } else {
+    const cwd = process.cwd();
+    const target = inspectTarget(cwd, home);
+    console.log(`\n安装范围: 项目 -> ${join(cwd, '.agents', 'skills')}`);
+
+    if (target.kind === 'home' && !force) {
+      console.error(`
+这是你的用户主目录。装到这里通常不是你想要的——想让所有项目都能用，请加 -g：
+
+  comate-skills init -g
+
+确实要装在这里，加 --force。`);
+      return 1;
+    }
+    if (target.kind === 'bare' && !force) {
+      console.error(`
+当前目录看不出是个项目（没有 .git / package.json / pyproject.toml 等标志）。
+comate 会把 skill 装进上面这个路径，先确认这是你要的目录：
+
+  cd <你的项目目录> && npx @house365/comate init   # 换个目录
+  npx @house365/comate init -g                     # 装到全局，所有项目可用
+  npx @house365/comate init --force                # 就装在这里`);
+      return 1;
+    }
+    if (target.kind === 'project') console.log(`检测到项目标志: ${target.marker}`);
+    console.log('');
+  }
 
   // 1. OpenSpec CLI — a PATH command, so global regardless of skill scope.
   const os = openSpecState();
@@ -91,9 +147,11 @@ function report(results, scope) {
     console.error(`\n${failed.length} 项失败。修复后可重跑 comate-skills init（已安装的会自动跳过）。`);
     return 1;
   }
-  const doctorPath =
-    scope === 'global' ? '~/.claude/skills/comate/scripts/comate.sh' : '.agents/skills/comate/scripts/comate.sh';
-  console.log(`\n完成。健康检查: bash ${doctorPath} doctor`);
+  // Absolute path: the user should not have to work out which directory this
+  // landed in, which is the whole problem with a cwd-relative install.
+  const root = scope === 'global' ? (process.env.HOME ?? process.env.USERPROFILE ?? '~') : process.cwd();
+  const doctorPath = join(root, '.agents', 'skills', 'comate', 'scripts', 'comate.sh');
+  console.log(`\n完成。健康检查: bash "${doctorPath}" doctor`);
   console.log('在 agent 中输入 /comate 开始使用。');
   return 0;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@house365/comate",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "comate —— OpenSpec + Superpowers 规约驱动的 AI 开发编排器（Agent Skills）",
   "type": "module",
   "license": "MIT",