ironweave 1.1.6 → 1.1.7

package/README.md

@@ -98,33 +98,60 @@ User Request
 
 ## Installation
 
-### Via skills.sh (Recommended)
+### Via npm
 
 ```bash
-# Install all skills at once (no prompts)
-npx skills add YuluoY/ironware --all
+# Install all skills + all agent configs (Chinese, default)
+npx ironweave@latest init
 
-# Interactive: select which skills to install
-npx skills add YuluoY/ironware
+# Install English skills
+npx ironweave@latest init --lang en
 
-# Install specific skills only
-npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
+# Install for a specific editor only
+npx ironweave@latest init --agent cursor
+npx ironweave@latest init --agent trae
+npx ironweave@latest init --agent windsurf
 
-# List available skills
-npx skills add YuluoY/ironware --list
+# Only copy skills, skip agent config files
+npx ironweave@latest init --skills-only
+
+# Overwrite existing files
+npx ironweave@latest init --force
+
+# List all available skills
+npx ironweave@latest list
 ```
 
-Or via npm (supports `--lang en` for English skills):
+Available agents: `claude`, `copilot`, `cursor`, `windsurf`, `cline`, `trae`, `codebuddy`, `codex`, `gemini`, `all` (default).
+
+> **Conflict handling**: Existing files are preserved by default. Ironweave adds its config alongside your existing rules. Use `--force` to overwrite.
+
+> **Skills location**: When targeting a single directory-based editor (e.g., `--agent trae`), skills are installed inside the editor directory (e.g., `.trae/skills/`). With `--agent all` (default), skills go to the project root `skills/`.
+
+### Via skills.sh
 
 ```bash
-# Install with Chinese skills (default)
-npx ironweave init
+# Install to a specific editor (recommended)
+npx skills add YuluoY/ironware --skill '*' -a cursor -y
+npx skills add YuluoY/ironware --skill '*' -a trae -y
+npx skills add YuluoY/ironware --skill '*' -a claude-code -y
 
-# Install with English skills
-npx ironweave init --lang en
+# Install to multiple editors
+npx skills add YuluoY/ironware --skill '*' -a cursor -a windsurf -y
+
+# Install to ALL editors (installs many agent directories)
+npx skills add YuluoY/ironware --all
+
+# Interactive: select skills and editors
+npx skills add YuluoY/ironware
+
+# List available skills
+npx skills add YuluoY/ironware --list
 ```
 
-Supports **9 agents**: Claude Code, GitHub Copilot, Cursor, Windsurf, Cline, Trae, CodeBuddy, Codex, Gemini CLI.
+Agent names for skills.sh: `claude-code`, `github-copilot`, `cursor`, `windsurf`, `cline`, `trae`, `codebuddy`, `codex`, `gemini-cli`.
+
+> Note: `skills.sh` does not support `--lang`. For English skills, use `npx ironweave@latest init --lang en`.
 
 ### Per-Agent Manual Installation
 

package/README_CN.md

@@ -96,33 +96,60 @@ Ironweave 是一套完整的软件开发工作流，由一组可自由组合的
 
 ## 安装
 
-### 通过 skills.sh（推荐）
+### 通过 npm
 
 ```bash
-# 一键安装全部技能（无交互提示）
-npx skills add YuluoY/ironware --all
+# 安装全部技能 + 全部编辑器配置（中文，默认）
+npx ironweave@latest init
 
-# 交互式选择要安装的技能
-npx skills add YuluoY/ironware
+# 安装英文版技能
+npx ironweave@latest init --lang en
 
-# 安装指定技能
-npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
+# 只安装特定编辑器的配置
+npx ironweave@latest init --agent cursor
+npx ironweave@latest init --agent trae
+npx ironweave@latest init --agent windsurf
 
-# 列出可用技能
-npx skills add YuluoY/ironware --list
+# 只复制 skills/，不安装编辑器配置
+npx ironweave@latest init --skills-only
+
+# 覆盖已有文件
+npx ironweave@latest init --force
+
+# 列出所有可用技能
+npx ironweave@latest list
 ```
 
-或通过 npm 安装（支持 `--lang en` 切换英文版）：
+可选编辑器：`claude`、`copilot`、`cursor`、`windsurf`、`cline`、`trae`、`codebuddy`、`codex`、`gemini`、`all`（默认全部）。
+
+> **冲突处理**：默认不覆盖已有文件。Ironweave 会将配置与你现有的规则并存。使用 `--force` 强制覆盖。
+
+> **Skills 位置**：指定单个目录型编辑器时（如 `--agent trae`），skills 会安装到该编辑器目录内（如 `.trae/skills/`）。使用 `--agent all`（默认）时，skills 安装在项目根目录 `skills/`。
+
+### 通过 skills.sh
 
 ```bash
-# 安装中文技能（默认）
-npx ironweave init
+# 安装到指定编辑器（推荐）
+npx skills add YuluoY/ironware --skill '*' -a cursor -y
+npx skills add YuluoY/ironware --skill '*' -a trae -y
+npx skills add YuluoY/ironware --skill '*' -a claude-code -y
 
-# 安装英文版技能
-npx ironweave init --lang en
+# 安装到多个编辑器
+npx skills add YuluoY/ironware --skill '*' -a cursor -a windsurf -y
+
+# 安装到所有编辑器（会生成很多 agent 目录）
+npx skills add YuluoY/ironware --all
+
+# 交互式选择技能和编辑器
+npx skills add YuluoY/ironware
+
+# 列出可用技能
+npx skills add YuluoY/ironware --list
 ```
 
-支持 **9 个 Agent**：Claude Code、GitHub Copilot、Cursor、Windsurf、Cline、Trae、CodeBuddy、Codex、Gemini CLI。
+skills.sh 的 Agent 名称：`claude-code`、`github-copilot`、`cursor`、`windsurf`、`cline`、`trae`、`codebuddy`、`codex`、`gemini-cli`。
+
+> 注意：`skills.sh` 不支持 `--lang` 参数。如需英文版，请使用 `npx ironweave@latest init --lang en`。
 
 ### 各 Agent 手动安装
 

package/bin/cli.js

@@ -51,12 +51,25 @@ if (command === 'init') {
   const skillsOnly = args.includes('--skills-only');
   const force = args.includes('--force');
 
-  // Copy skills/ and hooks/
+  // Directory-based agent roots (skills go inside agent dir for single-agent install)
+  const dirBasedAgents = {
+    cursor: '.cursor',
+    windsurf: '.windsurf',
+    cline: '.clinerules',
+    trae: '.trae',
+    codebuddy: '.codebuddy'
+  };
+  const isSingleDirAgent = agent !== 'all' && dirBasedAgents[agent];
+
+  // Copy skills/
   const skillsSrc = lang === 'en' ? 'skills-en' : 'skills';
   const srcSkills = path.join(pkgDir, skillsSrc);
-  const dstSkills = path.join(targetDir, 'skills');
+  const dstSkills = isSingleDirAgent
+    ? path.join(targetDir, dirBasedAgents[agent], 'skills')
+    : path.join(targetDir, 'skills');
   copyDirRecursive(srcSkills, dstSkills, force);
-  console.log(`✓ skills/ copied (${lang === 'en' ? 'English' : 'Chinese'})`);
+  const skillsLabel = isSingleDirAgent ? `${dirBasedAgents[agent]}/skills/` : 'skills/';
+  console.log(`✓ ${skillsLabel} copied (${lang === 'en' ? 'English' : 'Chinese'})`);
 
   const srcHooks = path.join(pkgDir, 'hooks');
   const dstHooks = path.join(targetDir, 'hooks');
@@ -115,6 +128,18 @@ if (command === 'init') {
           }
         }
       });
+      // Patch skills path references for single dir-based agent
+      if (isSingleDirAgent) {
+        const prefix = dirBasedAgents[agent] + '/';
+        files.forEach(f => {
+          const dstPath = path.join(targetDir, f.dst);
+          if (f.dir) {
+            patchSkillsPathsInDir(dstPath, prefix);
+          } else if (fs.existsSync(dstPath)) {
+            patchSkillsPathsInFile(dstPath, prefix);
+          }
+        });
+      }
       console.log(`✓ ${a} config installed`);
     });
   }
@@ -140,3 +165,18 @@ function copyDirRecursive(src, dst, force) {
     }
   }
 }
+
+function patchSkillsPathsInDir(dirPath, prefix) {
+  if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) return;
+  for (const entry of fs.readdirSync(dirPath, { withFileTypes: true })) {
+    const full = path.join(dirPath, entry.name);
+    if (entry.isDirectory()) patchSkillsPathsInDir(full, prefix);
+    else patchSkillsPathsInFile(full, prefix);
+  }
+}
+
+function patchSkillsPathsInFile(filePath, prefix) {
+  let content = fs.readFileSync(filePath, 'utf8');
+  const patched = content.replace(/`skills\//g, '`' + prefix + 'skills/');
+  if (patched !== content) fs.writeFileSync(filePath, patched);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ironweave",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "description": "Agentic skills framework for AI coding agents — orchestrated workflows with adaptive routing, quality gates, and 17 composable skills.",
   "keywords": [
     "agent-skills",