chore: gitignore local artifacts, update docs, unify metadata and bump versions

- .gitignore: ignore .agents/ .claude/ .codex/ chats/ (local tool
  output and private conversation exports, same nature as .planning/)
- CLAUDE.md/README/AGENTS.md: document scripts/, tests/, CI and the
  exact set of synced metadata fields; refresh stale AGENTS.md mirror
- plugin.json x5: add license MIT, bump patch versions (chat-saver
  0.6.1, codex-bridge 0.3.2, skill-extractor 0.1.3, update-plugins
  0.1.1, lark 1.0.61); marketplace.json/README table regenerated via
  scripts/sync-plugins.sh
- tests: refresh manual-checklist version stamps

Author: DropFan

.claude-plugin/marketplace.json

@@ -12,51 +12,62 @@
       "name": "codex-bridge",
       "source": "./plugins/codex-bridge",
       "description": "Bridge OpenAI Codex CLI into Claude Code for cross-model review, verification, task delegation and collaborative generation",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "author": {
         "name": "Tiger",
         "url": "https://github.com/DropFan"
-      }
+      },
+      "keywords": [
+        "codex",
+        "openai",
+        "code-review",
+        "cross-model"
+      ],
+      "license": "MIT"
     },
     {
       "name": "chat-saver",
       "source": "./plugins/chat-saver",
       "description": "Save, search, manage, and export Claude Code conversations to documents or external platforms",
-      "version": "0.6.0",
+      "version": "0.6.1",
       "author": {
         "name": "Tiger",
         "url": "https://github.com/DropFan"
-      }
+      },
+      "license": "MIT"
     },
     {
       "name": "skill-extractor",
       "source": "./plugins/skill-extractor",
       "description": "Extract reusable skills, commands, and agents from conversation history",
-      "version": "0.1.2",
+      "version": "0.1.3",
       "author": {
         "name": "Tiger",
         "url": "https://github.com/DropFan"
-      }
+      },
+      "license": "MIT"
     },
     {
       "name": "update-plugins",
       "source": "./plugins/update-plugins",
       "description": "Batch update all installed Claude Code plugins with a single command",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "author": {
         "name": "Tiger",
         "url": "https://github.com/DropFan"
-      }
+      },
+      "license": "MIT"
     },
     {
       "name": "lark",
       "source": "./plugins/lark",
       "description": "Operate Feishu/Lark (IM, Docs, Base, Sheets, Calendar, Drive, Wiki, Task, OKR, VC, etc.) via the local lark-cli. Mirrors the Claude Code lark skill set for Cowork. 飞书/Lark 全套技能。",
-      "version": "1.0.60",
+      "version": "1.0.61",
       "author": {
         "name": "Tiger",
         "url": "https://github.com/DropFan"
-      }
+      },
+      "license": "MIT"
     }
   ]
 }

.gitignore

@@ -19,3 +19,10 @@ __pycache__/
 
 # Planning docs (local-only)
 .planning/
+
+# Local tool artifacts and private session exports (local-only, same as .planning/)
+# Note: does NOT affect .claude-plugin/ directories (pattern matches the exact name only)
+.agents/
+.claude/
+.codex/
+chats/

AGENTS.md

@@ -0,0 +1,88 @@
+# Claude Code Plugins Collection
+
+<!-- This file mirrors CLAUDE.md. Keep the two in sync when editing either. -->
+
+This is a Claude Code plugin marketplace repository.
+
+## Repository Structure
+
+```
+.claude-plugin/
+  marketplace.json      # Marketplace manifest, declares all available plugins
+plugins/
+  <plugin-name>/        # Self-developed plugin directory
+    .claude-plugin/
+      plugin.json       # Plugin metadata
+    commands/            # User-invokable slash commands
+    agents/              # Subagent definitions
+    skills/              # Skill modules
+    hooks/               # Hook configurations
+scripts/
+  sync-plugins.sh       # Sync plugin.json metadata to marketplace.json and README.md
+  validate-plugins.sh   # Validate plugin structure and metadata (plugin.json, frontmatter, naming)
+  verify-sync.sh        # Detect drift between plugin.json and marketplace.json (--run-sync to fix)
+  lark-rebuild.py       # Rebuild the lark plugin from lark-cli skill sources
+tests/
+  run-tests.sh          # Automated test runner
+  *-manual-tests.md     # Manual test checklists per plugin
+.github/workflows/
+  ci.yml                # CI: validate-plugins + verify-sync + tests
+```
+
+## Plugin Management
+
+- **Self-developed plugins** — Source code lives directly under `plugins/<name>/`
+- **Curated plugins** — Referenced in `marketplace.json` via GitHub source pointing to external repos
+
+## Development Guidelines
+
+### Adding a Self-developed Plugin
+
+1. Create a plugin directory under `plugins/`
+2. Create `.claude-plugin/plugin.json` with metadata (this is the single source of truth)
+3. Add an entry to the `plugins` array in `marketplace.json` with a relative path as source
+4. Run `bash scripts/sync-plugins.sh` to auto-sync metadata to `marketplace.json` and `README.md`
+
+> **Note:** `plugin.json` is the single source of truth for self-developed plugins. Do NOT manually edit plugin metadata in `marketplace.json` or `README.md` — run the sync script instead. The sync covers the `description`, `version`, `author`, `keywords`, and `license` fields; other fields are not propagated.
+
+### Maintenance Scripts
+
+- `bash scripts/sync-plugins.sh` — run after changing any `plugin.json` to propagate metadata to `marketplace.json` and the README plugin table
+- `bash scripts/validate-plugins.sh` — run before committing to validate plugin structure and metadata
+- `bash scripts/verify-sync.sh` — run before committing to detect metadata drift (add `--run-sync` to fix it)
+- `bash tests/run-tests.sh` — run the automated tests; manual checklists live in `tests/*-manual-tests.md`
+
+CI (`.github/workflows/ci.yml`) runs validate-plugins, verify-sync, and the tests.
+
+### Adding a Curated Plugin
+
+Add an entry to the `plugins` array in `marketplace.json` using the GitHub source format:
+```json
+{
+  "name": "plugin-name",
+  "source": { "source": "github", "repo": "owner/repo" },
+  "description": "Description"
+}
+```
+
+### Component Naming Conventions
+
+- Commands: `commands/<command-name>.md`
+- Agents: `agents/<agent-name>.md`
+- Skills: `skills/<skill-name>/SKILL.md`
+- Hooks: `hooks/hooks.json`
+
+### plugin.json Template
+
+```json
+{
+  "name": "plugin-name",
+  "description": "Plugin description",
+  "version": "0.1.0",
+  "author": {
+    "name": "Tiger",
+    "url": "https://github.com/DropFan"
+  },
+  "license": "MIT"
+}
+```

CLAUDE.md

@@ -15,6 +15,16 @@ plugins/
     agents/              # Subagent definitions
     skills/              # Skill modules
     hooks/               # Hook configurations
+scripts/
+  sync-plugins.sh       # Sync plugin.json metadata to marketplace.json and README.md
+  validate-plugins.sh   # Validate plugin structure and metadata (plugin.json, frontmatter, naming)
+  verify-sync.sh        # Detect drift between plugin.json and marketplace.json (--run-sync to fix)
+  lark-rebuild.py       # Rebuild the lark plugin from lark-cli skill sources
+tests/
+  run-tests.sh          # Automated test runner
+  *-manual-tests.md     # Manual test checklists per plugin
+.github/workflows/
+  ci.yml                # CI: validate-plugins + verify-sync + tests
 ```
 
 ## Plugin Management
@@ -31,7 +41,16 @@ plugins/
 3. Add an entry to the `plugins` array in `marketplace.json` with a relative path as source
 4. Run `bash scripts/sync-plugins.sh` to auto-sync metadata to `marketplace.json` and `README.md`
 
-> **Note:** `plugin.json` is the single source of truth for self-developed plugins. Do NOT manually edit plugin metadata in `marketplace.json` or `README.md` — run the sync script instead.
+> **Note:** `plugin.json` is the single source of truth for self-developed plugins. Do NOT manually edit plugin metadata in `marketplace.json` or `README.md` — run the sync script instead. The sync covers the `description`, `version`, `author`, `keywords`, and `license` fields; other fields are not propagated.
+
+### Maintenance Scripts
+
+- `bash scripts/sync-plugins.sh` — run after changing any `plugin.json` to propagate metadata to `marketplace.json` and the README plugin table
+- `bash scripts/validate-plugins.sh` — run before committing to validate plugin structure and metadata
+- `bash scripts/verify-sync.sh` — run before committing to detect metadata drift (add `--run-sync` to fix it)
+- `bash tests/run-tests.sh` — run the automated tests; manual checklists live in `tests/*-manual-tests.md`
+
+CI (`.github/workflows/ci.yml`) runs validate-plugins, verify-sync, and the tests.
 
 ### Adding a Curated Plugin
 
@@ -61,6 +80,7 @@ Add an entry to the `plugins` array in `marketplace.json` using the GitHub sourc
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"
-  }
+  },
+  "license": "MIT"
 }
 ```

README.md

@@ -21,11 +21,11 @@ Then browse and install plugins:
 <!-- PLUGINS_TABLE_START -->
 | Plugin | Description | Author | Install | Version |
 |--------|-------------|--------|---------|---------|
-| [chat-saver](./plugins/chat-saver) | Save, search, manage, and export Claude Code conversations to documents or external platforms | [Tiger](https://github.com/DropFan) | `/plugin install chat-saver@tiger-plugins` | 0.6.0 |
-| [codex-bridge](./plugins/codex-bridge) | Bridge OpenAI Codex CLI into Claude Code for cross-model review, verification, task delegation and collaborative generation | [Tiger](https://github.com/DropFan) | `/plugin install codex-bridge@tiger-plugins` | 0.3.1 |
-| [lark](./plugins/lark) | Operate Feishu/Lark (IM, Docs, Base, Sheets, Calendar, Drive, Wiki, Task, OKR, VC, etc.) via the local lark-cli. Mirrors the Claude Code lark skill set for Cowork. 飞书/Lark 全套技能。 | [Tiger](https://github.com/DropFan) | `/plugin install lark@tiger-plugins` | 1.0.60 |
-| [skill-extractor](./plugins/skill-extractor) | Extract reusable skills, commands, and agents from conversation history | [Tiger](https://github.com/DropFan) | `/plugin install skill-extractor@tiger-plugins` | 0.1.2 |
-| [update-plugins](./plugins/update-plugins) | Batch update all installed Claude Code plugins with a single command | [Tiger](https://github.com/DropFan) | `/plugin install update-plugins@tiger-plugins` | 0.1.0 |
+| [chat-saver](./plugins/chat-saver) | Save, search, manage, and export Claude Code conversations to documents or external platforms | [Tiger](https://github.com/DropFan) | `/plugin install chat-saver@tiger-plugins` | 0.6.1 |
+| [codex-bridge](./plugins/codex-bridge) | Bridge OpenAI Codex CLI into Claude Code for cross-model review, verification, task delegation and collaborative generation | [Tiger](https://github.com/DropFan) | `/plugin install codex-bridge@tiger-plugins` | 0.3.2 |
+| [lark](./plugins/lark) | Operate Feishu/Lark (IM, Docs, Base, Sheets, Calendar, Drive, Wiki, Task, OKR, VC, etc.) via the local lark-cli. Mirrors the Claude Code lark skill set for Cowork. 飞书/Lark 全套技能。 | [Tiger](https://github.com/DropFan) | `/plugin install lark@tiger-plugins` | 1.0.61 |
+| [skill-extractor](./plugins/skill-extractor) | Extract reusable skills, commands, and agents from conversation history | [Tiger](https://github.com/DropFan) | `/plugin install skill-extractor@tiger-plugins` | 0.1.3 |
+| [update-plugins](./plugins/update-plugins) | Batch update all installed Claude Code plugins with a single command | [Tiger](https://github.com/DropFan) | `/plugin install update-plugins@tiger-plugins` | 0.1.1 |
 <!-- PLUGINS_TABLE_END -->
 
 ## Repository Structure
@@ -36,17 +36,31 @@ Then browse and install plugins:
 plugins/
   <plugin-name>/            # Self-developed plugins
     .claude-plugin/
-      plugin.json
+      plugin.json           # Plugin metadata (source of truth)
     commands/               # Slash commands (/command-name)
     agents/                 # Subagent definitions
     skills/                 # Skill modules
     hooks/                  # Hook configurations
+scripts/                    # Maintenance scripts (sync, validate, verify)
+tests/                      # Test runner and manual test checklists
+.github/workflows/          # CI configuration
 ```
 
 **Self-developed plugins** live under `plugins/` as source directories.
 
 **Curated plugins** are referenced in `marketplace.json` via GitHub source — no code duplication.
 
+## Development
+
+For self-developed plugins, `plugins/<name>/.claude-plugin/plugin.json` is the single source of truth for metadata. Do not hand-edit their entries in `marketplace.json` or the plugin table above — the sync script regenerates both, and manual edits will be overwritten.
+
+- `bash scripts/sync-plugins.sh` — sync `plugin.json` metadata (description, version, author, keywords, license) to `marketplace.json` and the README plugin table
+- `bash scripts/validate-plugins.sh` — validate plugin structure and metadata
+- `bash scripts/verify-sync.sh` — detect drift between `plugin.json` and `marketplace.json` (`--run-sync` to fix)
+- `bash tests/run-tests.sh` — run the automated tests; manual checklists live in `tests/*-manual-tests.md`
+
+CI (`.github/workflows/ci.yml`) runs validation, sync verification, and the tests.
+
 ## License
 
 MIT

plugins/chat-saver/.claude-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "name": "chat-saver",
   "description": "Save, search, manage, and export Claude Code conversations to documents or external platforms",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"
-  }
+  },
+  "license": "MIT"
 }

plugins/codex-bridge/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "codex-bridge",
   "description": "Bridge OpenAI Codex CLI into Claude Code for cross-model review, verification, task delegation and collaborative generation",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"

plugins/lark/.claude-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "name": "lark",
   "description": "Operate Feishu/Lark (IM, Docs, Base, Sheets, Calendar, Drive, Wiki, Task, OKR, VC, etc.) via the local lark-cli. Mirrors the Claude Code lark skill set for Cowork. 飞书/Lark 全套技能。",
-  "version": "1.0.60",
+  "version": "1.0.61",
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"
-  }
+  },
+  "license": "MIT"
 }

plugins/skill-extractor/.claude-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "name": "skill-extractor",
   "description": "Extract reusable skills, commands, and agents from conversation history",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"
-  }
+  },
+  "license": "MIT"
 }

plugins/update-plugins/.claude-plugin/plugin.json

@@ -1,9 +1,10 @@
 {
   "name": "update-plugins",
   "description": "Batch update all installed Claude Code plugins with a single command",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "author": {
     "name": "Tiger",
     "url": "https://github.com/DropFan"
-  }
+  },
+  "license": "MIT"
 }