tools-cc 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 本项目的所有重要变更都将记录在此文件中。
 
+## [1.0.9] - 2026-03-04
+
+### Added
+- 新增 rules 支持，可管理 rules 配置
+  - `tools-cc use source:rules/my-rule` 只导入指定 rule
+  - `tools-cc use source:rules/` 导入所有 rules
+  - 交互模式支持 rules 选择
+- Rules 存储在 `.toolscc/rules/<source>/` 目录
+
 ## [1.0.8] - 2026-03-04
 
 ### Added

package/CHANGELOG_en.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.9] - 2026-03-04
+
+### Added
+- Added rules support for managing rules configurations
+  - `tools-cc use source:rules/my-rule` import only specified rule
+  - `tools-cc use source:rules/` import all rules
+  - Interactive mode supports rules selection
+- Rules stored in `.toolscc/rules/<source>/` directory
+
 ## [1.0.8] - 2026-03-04
 
 ### Added

package/README.md

@@ -131,6 +131,7 @@ tools-cc use my-skills -p iflow claude codex    # 指定工具链接
 tools-cc use my-skills/skills/a-skill     # 引入单个 skill
 tools-cc use my-skills/commands/test      # 引入单个 command
 tools-cc use my-skills/agents/reviewer    # 引入单个 agent
+tools-cc use my-skills/rules/my-rule      # 引入单个 rule
 tools-cc use my-skills/skills/a my-skills/commands/test  # 引入多项
 
 # 交互式选择内容（--ls 参数）
@@ -168,6 +169,24 @@ tools-cc config get <key>                 # 查看配置
 tools-cc config list                      # 查看完整全局配置
 ```
 
+### Template 管理
+
+```bash
+# 完整命令 (template)
+tools-cc template save                    # 保存当前项目配置为模板 (缩写: tpl save)
+tools-cc template save -n my-template     # 指定模板名称保存
+tools-cc template list                    # 列出所有保存的模板 (缩写: template ls, tpl list, tpl ls)
+tools-cc template rm <name>               # 删除模板 (缩写: tpl rm)
+tools-cc template use [name]              # 应用模板到当前项目 (缩写: tpl use)
+
+# 快捷方式 (tpl)
+tools-cc tpl save                         # 保存当前项目配置为模板
+tools-cc tpl save -n my-template          # 指定模板名称保存
+tools-cc tpl list                         # 列出所有保存的模板
+tools-cc tpl rm <name>                    # 删除模板
+tools-cc tpl use [name]                   # 应用模板到当前项目
+```
+
 ### 帮助
 
 ```bash
@@ -198,8 +217,11 @@ my-skills/
 │       └── SKILL.md
 ├── commands/
 │   └── my-command.md
-└── agents/
-    └── my-agent.md
+├── agents/
+│   └── my-agent.md
+└── rules/
+    └── my-rule/
+        └── RULE.md
 ```
 
 ### manifest.json 格式
@@ -210,7 +232,8 @@ my-skills/
   "version": "1.0.0",
   "skills": ["my-skill"],
   "commands": ["my-command"],
-  "agents": ["my-agent"]
+  "agents": ["my-agent"],
+  "rules": ["my-rule"]
 }
 ```
 
@@ -228,7 +251,9 @@ my-project/
 │   │   └── my-skills-my-skill/
 │   ├── commands/
 │   │   └── my-skills/
-│   └── agents/
+│   ├── agents/
+│   │   └── my-skills/
+│   └── rules/
 │       └── my-skills/
 ├── .iflow -> .toolscc            # 符号链接
 ├── .claude -> .toolscc
@@ -263,7 +288,8 @@ my-project/
     "my-skills": {
       "skills": ["a-skill", "b-skill"],
       "commands": ["test"],
-      "agents": ["*"]
+      "agents": ["*"],
+      "rules": []
     }
   },
   "links": ["iflow", "claude", "codex"]

package/README_en.md

@@ -122,6 +122,7 @@ tools-cc use my-skills -p iflow claude codex    # Specify tool links
 tools-cc use my-skills/skills/a-skill     # Import single skill
 tools-cc use my-skills/commands/test      # Import single command
 tools-cc use my-skills/agents/reviewer    # Import single agent
+tools-cc use my-skills/rules/my-rule      # Import single rule
 tools-cc use my-skills/skills/a my-skills/commands/test  # Import multiple
 
 # Interactive content selection (--ls flag)
@@ -159,6 +160,24 @@ tools-cc config get <key>                 # Get configuration
 tools-cc config list                      # View complete global configuration
 ```
 
+### Template Management
+
+```bash
+# Full commands (template)
+tools-cc template save                    # Save current project config as template (alias: tpl save)
+tools-cc template save -n my-template     # Save with specified template name
+tools-cc template list                    # List all saved templates (alias: template ls, tpl list, tpl ls)
+tools-cc template rm <name>               # Remove a template (alias: tpl rm)
+tools-cc template use [name]              # Apply a template to current project (alias: tpl use)
+
+# Shortcuts (tpl)
+tools-cc tpl save                         # Save current project config as template
+tools-cc tpl save -n my-template          # Save with specified template name
+tools-cc tpl list                         # List all saved templates
+tools-cc tpl rm <name>                    # Remove a template
+tools-cc tpl use [name]                   # Apply a template to current project
+```
+
 ### Help
 
 ```bash
@@ -189,8 +208,11 @@ my-skills/
 │       └── SKILL.md
 ├── commands/
 │   └── my-command.md
-└── agents/
-    └── my-agent.md
+├── agents/
+│   └── my-agent.md
+└── rules/
+    └── my-rule/
+        └── RULE.md
 ```
 
 ### manifest.json Format
@@ -201,7 +223,8 @@ my-skills/
   "version": "1.0.0",
   "skills": ["my-skill"],
   "commands": ["my-command"],
-  "agents": ["my-agent"]
+  "agents": ["my-agent"],
+  "rules": ["my-rule"]
 }
 ```
 
@@ -219,7 +242,9 @@ my-project/
 │   │   └── my-skills-my-skill/
 │   ├── commands/
 │   │   └── my-skills/
-│   └── agents/
+│   ├── agents/
+│   │   └── my-skills/
+│   └── rules/
 │       └── my-skills/
 ├── .iflow -> .toolscc            # Symbolic link
 └── .claude -> .toolscc
@@ -253,7 +278,8 @@ my-project/
     "my-skills": {
       "skills": ["a-skill", "b-skill"],
       "commands": ["test"],
-      "agents": ["*"]
+      "agents": ["*"],
+      "rules": []
     }
   },
   "links": ["iflow", "claude", "codex"]

package/dist/commands/help.js

@@ -28,7 +28,7 @@ ${chalk_1.default.bold('COMMANDS / 命令')}
     tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
     tools-cc sources list, ls                    List all sources / 列出所有配置源
     tools-cc sources remove, rm <name>           Remove a source / 移除配置源
-    tools-cc sources update, up [name]           git pull update / 更新源代码
+    tools-cc sources update, up, upgrade [name]  git pull update / 更新源代码
     tools-cc sources scan                        Scan dir for sources / 扫描发现新源
     
     ${chalk_1.default.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
@@ -48,6 +48,14 @@ ${chalk_1.default.bold('COMMANDS / 命令')}
     tools-cc status                              Show project status / 显示项目状态
     tools-cc export [options]                    Export config / 导出配置
 
+  ${chalk_1.default.cyan('Template Management / 模板管理')}
+    tools-cc template save [-n <name>]           Save project config as template / 保存项目配置为模板
+    tools-cc template list, ls                   List all templates / 列出所有模板
+    tools-cc template rm <name>                  Delete template / 删除模板
+    tools-cc template use [name]                 Apply template to project / 应用模板到项目
+    
+    ${chalk_1.default.gray('Shortcut: tpl')}  e.g., tools-cc tpl save, tools-cc tpl list
+
   ${chalk_1.default.cyan('Help / 帮助')}
     tools-cc help                                Show this help / 显示此帮助信息
     tools-cc --help, -h                          Show command help / 显示命令帮助
@@ -100,6 +108,15 @@ ${chalk_1.default.bold('EXAMPLES / 示例')}
   ${chalk_1.default.gray('# Export project config / 导出项目配置')}
   tools-cc export -o my-config.json
 
+  ${chalk_1.default.gray('# Save project config as template / 保存项目配置为模板')}
+  tools-cc template save -n my-template
+
+  ${chalk_1.default.gray('# List all templates / 列出所有模板')}
+  tools-cc template list
+
+  ${chalk_1.default.gray('# Apply template to project / 应用模板到项目')}
+  tools-cc template use my-template
+
   ${chalk_1.default.gray('# Show full configuration / 显示完整配置')}
   tools-cc config list
 

package/dist/commands/use.js

@@ -156,6 +156,13 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
                 choices.push({ name: agent, value: `agents/${agent}` });
             }
         }
+        // Rules 区
+        if (manifest.rules && manifest.rules.length > 0) {
+            choices.push(new inquirer_1.default.Separator(`--- Rules (${manifest.rules.length}) ---`));
+            for (const rule of manifest.rules) {
+                choices.push({ name: rule, value: `rules/${rule}` });
+            }
+        }
         if (choices.length === 0) {
             console.log(chalk_1.default.yellow(`No items found in source: ${sourceName}`));
             return;
@@ -178,7 +185,8 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
         const selection = {
             skills: [],
             commands: [],
-            agents: []
+            agents: [],
+            rules: []
         };
         for (const item of answers.selectedItems) {
             const [type, name] = item.split('/');
@@ -188,6 +196,8 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
                 selection.commands.push(name);
             else if (type === 'agents')
                 selection.agents.push(name);
+            else if (type === 'rules')
+                selection.rules.push(name);
         }
         // 初始化项目并应用选择
         await (0, project_1.initProject)(projectDir);

package/dist/core/manifest.js

@@ -26,7 +26,8 @@ async function scanSource(sourceDir) {
         version: '0.0.0',
         skills: [],
         commands: [],
-        agents: []
+        agents: [],
+        rules: []
     };
     // Scan skills
     const skillsDir = path_1.default.join(sourceDir, 'skills');
@@ -52,5 +53,13 @@ async function scanSource(sourceDir) {
             .filter(e => e.isFile() && e.name.endsWith('.md'))
             .map(e => e.name.replace('.md', ''));
     }
+    // Scan rules
+    const rulesDir = path_1.default.join(sourceDir, 'rules');
+    if (await fs_extra_1.default.pathExists(rulesDir)) {
+        const entries = await fs_extra_1.default.readdir(rulesDir, { withFileTypes: true });
+        manifest.rules = entries
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+    }
     return manifest;
 }

package/dist/core/project.js

@@ -20,7 +20,8 @@ const path_2 = require("../utils/path");
 const DEFAULT_SELECTION = {
     skills: ['*'],
     commands: ['*'],
-    agents: ['*']
+    agents: ['*'],
+    rules: ['*']
 };
 async function initProject(projectDir) {
     const toolsccDir = (0, path_2.getToolsccDir)(projectDir);
@@ -29,6 +30,7 @@ async function initProject(projectDir) {
     await fs_extra_1.default.ensureDir(path_1.default.join(toolsccDir, 'skills'));
     await fs_extra_1.default.ensureDir(path_1.default.join(toolsccDir, 'commands'));
     await fs_extra_1.default.ensureDir(path_1.default.join(toolsccDir, 'agents'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(toolsccDir, 'rules'));
     // Create project config if not exists
     if (!(await fs_extra_1.default.pathExists(configFile))) {
         const config = {
@@ -139,6 +141,28 @@ async function useSource(sourceName, sourceDir, projectDir, selection) {
             }
         }
     }
+    // Copy rules (in subdirectory by source name)
+    const sourceRulesDir = path_1.default.join(sourceDir, 'rules');
+    if (await fs_extra_1.default.pathExists(sourceRulesDir)) {
+        // 检查是否有选择 rules
+        if (effectiveSelection.rules.includes('*')) {
+            // 复制所有 rules
+            const destDir = path_1.default.join(toolsccDir, 'rules', sourceName);
+            await fs_extra_1.default.remove(destDir);
+            await fs_extra_1.default.copy(sourceRulesDir, destDir);
+        }
+        else if (effectiveSelection.rules.length > 0) {
+            // 只复制选中的 rules
+            const destDir = path_1.default.join(toolsccDir, 'rules', sourceName);
+            await fs_extra_1.default.ensureDir(destDir);
+            for (const ruleName of effectiveSelection.rules) {
+                const srcDir = path_1.default.join(sourceRulesDir, ruleName);
+                if (await fs_extra_1.default.pathExists(srcDir)) {
+                    await fs_extra_1.default.copy(srcDir, path_1.default.join(destDir, ruleName));
+                }
+            }
+        }
+    }
     // Update project config - 保存实际使用的选择配置
     const configFile = (0, path_2.getProjectConfigPath)(projectDir);
     const config = await readProjectConfig(configFile);
@@ -166,6 +190,8 @@ async function unuseSource(sourceName, projectDir) {
     await fs_extra_1.default.remove(path_1.default.join(toolsccDir, 'commands', sourceName));
     // Remove agents subdirectory
     await fs_extra_1.default.remove(path_1.default.join(toolsccDir, 'agents', sourceName));
+    // Remove rules subdirectory
+    await fs_extra_1.default.remove(path_1.default.join(toolsccDir, 'rules', sourceName));
     // Update project config with error handling
     let config;
     try {

package/dist/types/config.d.ts

@@ -8,12 +8,13 @@ export interface GlobalConfig {
     sources: Record<string, SourceConfig>;
 }
 /**
- * 源选择配置 - 指定从源中导入哪些 skills/commands/agents
+ * 源选择配置 - 指定从源中导入哪些 skills/commands/agents/rules
  */
 export interface SourceSelection {
     skills: string[];
     commands: string[];
     agents: string[];
+    rules: string[];
 }
 /**
  * 新版项目配置 - sources 使用 Record 格式支持部分导入
@@ -44,6 +45,7 @@ export interface Manifest {
     skills?: string[];
     commands?: string[];
     agents?: string[];
+    rules?: string[];
 }
 export interface ToolConfig {
     linkName: string;

package/dist/types/config.js

@@ -11,7 +11,8 @@ function isSourceSelection(value) {
     const obj = value;
     return (Array.isArray(obj.skills) &&
         Array.isArray(obj.commands) &&
-        Array.isArray(obj.agents));
+        Array.isArray(obj.agents) &&
+        Array.isArray(obj.rules));
 }
 /**
  * 将旧版项目配置转换为新版格式
@@ -25,7 +26,8 @@ function normalizeProjectConfig(config) {
             newSources[sourceName] = {
                 skills: ['*'],
                 commands: ['*'],
-                agents: ['*']
+                agents: ['*'],
+                rules: ['*']
             };
         }
         return { sources: newSources, links: config.links };

package/dist/utils/parsePath.d.ts

@@ -4,7 +4,7 @@ import { SourceSelection } from '../types/config';
  */
 export interface ParsedSourcePath {
     sourceName: string;
-    type?: 'skills' | 'commands' | 'agents';
+    type?: 'skills' | 'commands' | 'agents' | 'rules';
     itemName?: string;
 }
 /**

package/dist/utils/parsePath.js

@@ -25,7 +25,7 @@ function parseSourcePath(input) {
         return { sourceName };
     }
     // 检查第二部分是否为有效类型
-    const validTypes = ['skills', 'commands', 'agents'];
+    const validTypes = ['skills', 'commands', 'agents', 'rules'];
     const type = parts[1];
     if (!validTypes.includes(type)) {
         return { sourceName };
@@ -63,7 +63,8 @@ function buildSelectionFromPaths(paths) {
             result[sourceName] = {
                 skills: [],
                 commands: [],
-                agents: []
+                agents: [],
+                rules: []
             };
         }
         // 如果没有指定类型和项目名称，表示整个源
@@ -71,7 +72,8 @@ function buildSelectionFromPaths(paths) {
             result[sourceName] = {
                 skills: ['*'],
                 commands: ['*'],
-                agents: ['*']
+                agents: ['*'],
+                rules: ['*']
             };
             continue;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {

package/src/commands/help.ts

@@ -23,7 +23,7 @@ ${chalk.bold('COMMANDS / 命令')}
     tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
     tools-cc sources list, ls                    List all sources / 列出所有配置源
     tools-cc sources remove, rm <name>           Remove a source / 移除配置源
-    tools-cc sources update, up [name]           git pull update / 更新源代码
+    tools-cc sources update, up, upgrade [name]  git pull update / 更新源代码
     tools-cc sources scan                        Scan dir for sources / 扫描发现新源
     
     ${chalk.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
@@ -43,6 +43,14 @@ ${chalk.bold('COMMANDS / 命令')}
     tools-cc status                              Show project status / 显示项目状态
     tools-cc export [options]                    Export config / 导出配置
 
+  ${chalk.cyan('Template Management / 模板管理')}
+    tools-cc template save [-n <name>]           Save project config as template / 保存项目配置为模板
+    tools-cc template list, ls                   List all templates / 列出所有模板
+    tools-cc template rm <name>                  Delete template / 删除模板
+    tools-cc template use [name]                 Apply template to project / 应用模板到项目
+    
+    ${chalk.gray('Shortcut: tpl')}  e.g., tools-cc tpl save, tools-cc tpl list
+
   ${chalk.cyan('Help / 帮助')}
     tools-cc help                                Show this help / 显示此帮助信息
     tools-cc --help, -h                          Show command help / 显示命令帮助
@@ -95,6 +103,15 @@ ${chalk.bold('EXAMPLES / 示例')}
   ${chalk.gray('# Export project config / 导出项目配置')}
   tools-cc export -o my-config.json
 
+  ${chalk.gray('# Save project config as template / 保存项目配置为模板')}
+  tools-cc template save -n my-template
+
+  ${chalk.gray('# List all templates / 列出所有模板')}
+  tools-cc template list
+
+  ${chalk.gray('# Apply template to project / 应用模板到项目')}
+  tools-cc template use my-template
+
   ${chalk.gray('# Show full configuration / 显示完整配置')}
   tools-cc config list
 

package/src/commands/use.ts

@@ -195,6 +195,14 @@ async function handleInteractiveMode(
       }
     }
 
+    // Rules 区
+    if (manifest.rules && manifest.rules.length > 0) {
+      choices.push(new inquirer.Separator(`--- Rules (${manifest.rules.length}) ---`));
+      for (const rule of manifest.rules) {
+        choices.push({ name: rule, value: `rules/${rule}` });
+      }
+    }
+
     if (choices.length === 0) {
       console.log(chalk.yellow(`No items found in source: ${sourceName}`));
       return;
@@ -220,7 +228,8 @@ async function handleInteractiveMode(
     const selection: SourceSelection = {
       skills: [],
       commands: [],
-      agents: []
+      agents: [],
+      rules: []
     };
 
     for (const item of answers.selectedItems) {
@@ -228,6 +237,7 @@ async function handleInteractiveMode(
       if (type === 'skills') selection.skills.push(name);
       else if (type === 'commands') selection.commands.push(name);
       else if (type === 'agents') selection.agents.push(name);
+      else if (type === 'rules') selection.rules.push(name);
     }
 
     // 初始化项目并应用选择

package/src/core/manifest.ts

@@ -1,57 +1,67 @@
-import fs from 'fs-extra';
-import path from 'path';
-import { Manifest } from '../types';
-
-export async function loadManifest(sourceDir: string): Promise<Manifest> {
-  const manifestPath = path.join(sourceDir, 'manifest.json');
-  
-  if (await fs.pathExists(manifestPath)) {
-    try {
-      return await fs.readJson(manifestPath);
-    } catch (error) {
-      throw new Error(`Failed to parse manifest.json: ${error instanceof Error ? error.message : 'Invalid JSON'}`);
-    }
-  }
-  
-  return scanSource(sourceDir);
-}
-
-export async function scanSource(sourceDir: string): Promise<Manifest> {
-  const name = path.basename(sourceDir);
-  const manifest: Manifest = {
-    name,
-    version: '0.0.0',
-    skills: [],
-    commands: [],
-    agents: []
-  };
-  
-  // Scan skills
-  const skillsDir = path.join(sourceDir, 'skills');
-  if (await fs.pathExists(skillsDir)) {
-    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-    manifest.skills = entries
-      .filter(e => e.isDirectory())
-      .map(e => e.name);
-  }
-  
-  // Scan commands
-  const commandsDir = path.join(sourceDir, 'commands');
-  if (await fs.pathExists(commandsDir)) {
-    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
-    manifest.commands = entries
-      .filter(e => e.isFile() && e.name.endsWith('.md'))
-      .map(e => e.name.replace('.md', ''));
-  }
-  
-  // Scan agents
-  const agentsDir = path.join(sourceDir, 'agents');
-  if (await fs.pathExists(agentsDir)) {
-    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
-    manifest.agents = entries
-      .filter(e => e.isFile() && e.name.endsWith('.md'))
-      .map(e => e.name.replace('.md', ''));
-  }
-  
-  return manifest;
-}
+import fs from 'fs-extra';
+import path from 'path';
+import { Manifest } from '../types';
+
+export async function loadManifest(sourceDir: string): Promise<Manifest> {
+  const manifestPath = path.join(sourceDir, 'manifest.json');
+  
+  if (await fs.pathExists(manifestPath)) {
+    try {
+      return await fs.readJson(manifestPath);
+    } catch (error) {
+      throw new Error(`Failed to parse manifest.json: ${error instanceof Error ? error.message : 'Invalid JSON'}`);
+    }
+  }
+  
+  return scanSource(sourceDir);
+}
+
+export async function scanSource(sourceDir: string): Promise<Manifest> {
+  const name = path.basename(sourceDir);
+  const manifest: Manifest = {
+    name,
+    version: '0.0.0',
+    skills: [],
+    commands: [],
+    agents: [],
+    rules: []
+  };
+  
+  // Scan skills
+  const skillsDir = path.join(sourceDir, 'skills');
+  if (await fs.pathExists(skillsDir)) {
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    manifest.skills = entries
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+  }
+  
+  // Scan commands
+  const commandsDir = path.join(sourceDir, 'commands');
+  if (await fs.pathExists(commandsDir)) {
+    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+    manifest.commands = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  // Scan agents
+  const agentsDir = path.join(sourceDir, 'agents');
+  if (await fs.pathExists(agentsDir)) {
+    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+    manifest.agents = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  // Scan rules
+  const rulesDir = path.join(sourceDir, 'rules');
+  if (await fs.pathExists(rulesDir)) {
+    const entries = await fs.readdir(rulesDir, { withFileTypes: true });
+    manifest.rules = entries
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+  }
+  
+  return manifest;
+}