@tofrankie/agents-sync 0.0.3 → 0.0.4

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## agents-sync@0.0.4 (2026-05-09)
+
+- No functional changes
+
 ## agents-sync@0.0.3 (2026-04-22)
 
 - Update CLI interaction

package/README.md

@@ -3,3 +3,5 @@
 [![npm version](https://img.shields.io/npm/v/@tofrankie/agents-sync)](https://www.npmjs.com/package/@tofrankie/agents-sync) [![node version](https://img.shields.io/node/v/@tofrankie/agents-sync)](https://nodejs.org) [![npm package license](https://img.shields.io/npm/l/@tofrankie/agents-sync)](https://github.com/tofrankie/agents-sync/blob/main/LICENSE) [![npm last update](https://img.shields.io/npm/last-update/@tofrankie/agents-sync)](https://www.npmjs.com/package/@tofrankie/agents-sync)
 
 🤯 WIP...
+
+> Maybe [Rulesync](https://github.com/dyoshikawa/rulesync) is what you're looking for.

package/dist/cli.mjs

@@ -363,7 +363,7 @@ async function runSkillCommand(cwd, options) {
 //#endregion
 //#region package.json
 var name = "@tofrankie/agents-sync";
-var version = "0.0.3";
+var version = "0.0.4";
 //#endregion
 //#region src/cli/index.ts
 main().catch((error) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tofrankie/agents-sync",
   "type": "module",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Sync skills, rules, and MCP from a configurable source into your project",
   "author": "Frankie <1426203851@qq.com> (https://github.com/tofrankie)",
   "license": "MIT",

package/README.local.md

@@ -1,218 +0,0 @@
-# @tofrankie/agents-sync (Local Draft)
-
-[![npm version](https://img.shields.io/npm/v/@tofrankie/agents-sync)](https://www.npmjs.com/package/@tofrankie/agents-sync) [![node version](https://img.shields.io/node/v/@tofrankie/agents-sync)](https://nodejs.org) [![npm package license](https://img.shields.io/npm/l/@tofrankie/agents-sync)](https://github.com/tofrankie/agents-sync/blob/main/LICENSE) [![npm last update](https://img.shields.io/npm/last-update/@tofrankie/agents-sync)](https://www.npmjs.com/package/@tofrankie/agents-sync)
-
-`agents-sync` 是一个用于同步 AI Agent 相关资源的 CLI 工具。当前版本聚焦于：
-
-- `skill`：多 Agent 兼容同步（统一落到项目 `.agents/skills`）
-- `rule`：首版仅支持 Cursor（写入 `.cursor/rules`）
-- `mcp`：首版仅支持 Cursor（写入 `.cursor/mcp.json`）
-
-> 当前文档是本地草稿，暂不对外发布。
-
-## 1. 设计目标
-
-- 从统一来源（默认 `~/.agents`）同步可复用的能力资产
-- 在不同 Agent 生态之间，尽量用最少心智成本管理 skills
-- 对差异较大的 rules / mcp，先收敛范围，确保首版稳定
-
-## 2. 当前能力边界（v1）
-
-- `skill`
-  - 支持目标 Agent：`cursor | claude | codex | gemini`
-  - 默认仍写入项目 `./.agents/skills/<skill-name>/`
-- `rule`
-  - 仅支持目标 Agent：`cursor`
-  - 目标目录：`./.cursor/rules/`
-  - 源文件若为 `.md`，落盘会转为 `.mdc`
-- `mcp`
-  - 仅支持目标 Agent：`cursor`
-  - 目标文件：`./.cursor/mcp.json`
-- 对不支持的组合（如 `rule --target-agent codex`）：
-  - 输出友好提示并跳过，不中断整个流程
-
-## 3. 安装与运行
-
-### 3.1 本地开发
-
-```bash
-pnpm install
-pnpm dev
-```
-
-### 3.2 构建
-
-```bash
-pnpm build
-```
-
-构建产物默认在 `dist/`，并通过 `bin` 暴露 `agents-sync` 命令。
-
-## 4. 命令总览
-
-```bash
-agents-sync skill [options]
-agents-sync rule [options]
-agents-sync mcp [options]
-```
-
-### 4.1 公共参数
-
-- `-s, --source <path>`：源路径（默认 `~/.agents`）
-- `-t, --target-agent <agent>`：目标 Agent（默认 `cursor`）
-- `--scope <project|user>`：作用域（默认 `project`）
-- `-c, --config <path>`：显式配置文件路径
-- `--dry-run`：仅展示计划，不落盘
-- `-y, --yes`：跳过交互，并在冲突时按覆盖策略执行
-
-## 5. 使用示例
-
-### 5.1 同步 skills（交互选择）
-
-```bash
-agents-sync skill
-```
-
-行为：
-
-- 从 `~/.agents` 发现 skill
-- 交互多选
-- 同步到 `./.agents/skills/`
-
-### 5.2 同步 Cursor rules
-
-```bash
-agents-sync rule --target-agent cursor
-```
-
-### 5.3 同步 Cursor MCP（先预览）
-
-```bash
-agents-sync mcp --dry-run
-agents-sync mcp
-```
-
-## 6. 配置文件
-
-支持自动发现以下文件名：
-
-- `agents-sync.config.js`
-- `agents-sync.config.cjs`
-- `agents-sync.config.mjs`
-- `agents-sync.config.ts`
-- `agents-sync.config.cts`
-- `agents-sync.config.mts`
-
-也可通过 `--config` 显式指定。
-
-### 6.1 配置示例
-
-```ts
-import { defineConfig } from '@tofrankie/agents-sync'
-
-export default defineConfig({
-  sourceDir: ['~/.agents'],
-  agent: 'cursor',
-  conflictPolicy: 'ask',
-  mapping: {
-    cursor: {
-      skillsDir: '.agents/skills',
-      rulesDir: '.cursor/rules',
-      mcpFile: '.cursor/mcp.json',
-    },
-  },
-})
-```
-
-说明：
-
-- 配置 key：`sourceDir`、`agent`
-- `sourceDir` 与 `agent` 支持字符串或字符串数组（数组取第一个值）
-
-### 6.2 参数优先级
-
-1. CLI 参数
-2. 配置文件
-3. 内置默认值
-
-## 7. 同步策略说明
-
-### 7.1 skills
-
-- 发现源目录中的技能目录（需包含 `SKILL.md`）
-- 文件级复制
-- 冲突时：
-  - `--yes`：覆盖
-  - 无 `--yes`：跳过冲突文件，但继续同步同 skill 下其他文件
-
-### 7.2 rules（Cursor）
-
-- 发现 `.md`/`.mdc` 规则文件
-- 落盘到 `.cursor/rules/`
-- `.md` 自动转 `.mdc` 后缀
-
-### 7.3 mcp（Cursor）
-
-- 读取源 `mcp.json`（或 `.cursor/mcp.json`）
-- 标准化后渲染为 Cursor 可用 JSON
-- 写入 `.cursor/mcp.json`
-
-## 8. 路径映射与导入约定
-
-- TS 路径别名：`@/* -> src/*`
-- 源码采用 `@/` 导入
-- `test/` 目录保持相对路径导入（便于测试语义清晰）
-
-## 9. 测试与质量保障
-
-```bash
-pnpm test
-pnpm typecheck
-pnpm lint
-```
-
-当前已覆盖：
-
-- 配置解析优先级与默认值
-- home 路径展开
-- skills/rules/mcp 核心同步路径
-- mcp 渲染目标限制
-
-## 10. 已知限制与后续计划
-
-- v1 的 `rule/mcp` 仅支持 Cursor
-- 其他 Agent 的 rules/mcp 路径仅做档案保留，后续扩展
-- 后续可增强：
-  - `--diff` 冲突前预览
-  - 更细粒度覆盖策略
-  - 更多资源类型（prompts/templates 等）
-
-## 11. 目录结构（当前实现）
-
-```text
-src/
-  cli/
-    commands/
-      skill.ts
-      rule.ts
-      mcp.ts
-    common.ts
-  core/
-    agent-profiles.ts
-    config-loader.ts
-    sync-engine.ts
-    path.ts
-  types/
-    core.ts
-    config.ts
-  index.ts
-test/
-  *.test.ts
-```
-
-## 12. 对外发布前建议
-
-- 补充英文版 README
-- 增加 CLI 帮助输出截图/示例
-- 明确 changelog 中的“支持矩阵”
-- 补一组命令级集成测试（尤其错误与跳过提示）