foliko 1.1.8 → 1.1.9

package/skills/find-skills/SKILL.md

@@ -1,133 +1,133 @@
----
-name: find-skills
-description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
----
-
-# Find Skills
-
-This skill helps you discover and install skills from the open agent skills ecosystem.
-
-## When to Use This Skill
-
-Use this skill when the user:
-
-- Asks "how do I do X" where X might be a common task with an existing skill
-- Says "find a skill for X" or "is there a skill for X"
-- Asks "can you do X" where X is a specialized capability
-- Expresses interest in extending agent capabilities
-- Wants to search for tools, templates, or workflows
-- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
-
-## What is the Skills CLI?
-
-The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
-
-**Key commands:**
-
-- `npx skills find [query]` - Search for skills interactively or by keyword
-- `npx skills add <package>` - Install a skill from GitHub or other sources
-- `npx skills check` - Check for skill updates
-- `npx skills update` - Update all installed skills
-
-**Browse skills at:** https://skills.sh/
-
-## How to Help Users Find Skills
-
-### Step 1: Understand What They Need
-
-When a user asks for help with something, identify:
-
-1. The domain (e.g., React, testing, design, deployment)
-2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
-3. Whether this is a common enough task that a skill likely exists
-
-### Step 2: Search for Skills
-
-Run the find command with a relevant query:
-
-```bash
-npx skills find [query]
-```
-
-For example:
-
-- User asks "how do I make my React app faster?" → `npx skills find react performance`
-- User asks "can you help me with PR reviews?" → `npx skills find pr review`
-- User asks "I need to create a changelog" → `npx skills find changelog`
-
-The command will return results like:
-
-```
-Install with npx skills add <owner/repo@skill>
-
-vercel-labs/agent-skills@vercel-react-best-practices
-└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
-```
-
-### Step 3: Present Options to the User
-
-When you find relevant skills, present them to the user with:
-
-1. The skill name and what it does
-2. The install command they can run
-3. A link to learn more at skills.sh
-
-Example response:
-
-```
-I found a skill that might help! The "vercel-react-best-practices" skill provides
-React and Next.js performance optimization guidelines from Vercel Engineering.
-
-To install it:
-npx skills add vercel-labs/agent-skills@vercel-react-best-practices
-
-Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
-```
-
-### Step 4: Offer to Install
-
-If the user wants to proceed, you can install the skill for them:
-
-```bash
-npx skills add <owner/repo@skill> -g -y
-```
-
-The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
-
-## Common Skill Categories
-
-When searching, consider these common categories:
-
-| Category        | Example Queries                          |
-| --------------- | ---------------------------------------- |
-| Web Development | react, nextjs, typescript, css, tailwind |
-| Testing         | testing, jest, playwright, e2e           |
-| DevOps          | deploy, docker, kubernetes, ci-cd        |
-| Documentation   | docs, readme, changelog, api-docs        |
-| Code Quality    | review, lint, refactor, best-practices   |
-| Design          | ui, ux, design-system, accessibility     |
-| Productivity    | workflow, automation, git                |
-
-## Tips for Effective Searches
-
-1. **Use specific keywords**: "react testing" is better than just "testing"
-2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
-3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
-
-## When No Skills Are Found
-
-If no relevant skills exist:
-
-1. Acknowledge that no existing skill was found
-2. Offer to help with the task directly using your general capabilities
-3. Suggest the user could create their own skill with `npx skills init`
-
-Example:
-
-```
-I searched for skills related to "xyz" but didn't find any matches.
-I can still help you with this task directly! Would you like me to proceed?
-
-If this is something you do often, you could create your own skill:
-npx skills init my-xyz-skill
-```
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Search for Skills
+
+Run the find command with a relevant query:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+The command will return results like:
+
+```
+Install with npx skills add <owner/repo@skill>
+
+vercel-labs/agent-skills@vercel-react-best-practices
+└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 3: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install command they can run
+3. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "vercel-react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+
+To install it:
+npx skills add vercel-labs/agent-skills@vercel-react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 4: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```

package/skills/foliko-dev/SKILL.md

@@ -177,6 +177,12 @@ module.exports = function (Plugin) {
 | **文件夹插件** | `.agent/plugins/插件名/node_modules/` | 插件自包含，可独立迁移 |
 | **单文件插件** | `.agent/node_modules/`                | 共享依赖               |
 
+### 重要依赖版本要求
+
+**zod 必须使用 `"zod": "^3.25.76"` 版本**
+
+其他依赖版本无特殊要求。
+
 ### 自动安装工具
 
 框架提供了 `install` 工具，支持以下用法：

package/skills/python-plugin-dev/SKILL.md

@@ -6,6 +6,44 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 
 # Python 插件开发
 
+## ext_call 调用方式
+
+通过 `ext_call` 工具调用 Python 插件：
+
+```javascript
+ext_call({
+  plugin: "插件名",    // 插件名称（必须）
+  tool: "工具名",      // 工具名称（必须）
+  args: {...}          // 工具参数（必须）
+});
+```
+
+**注意**：插件下的工具调用时，`tool` 参数格式为：
+
+- 如果工具名是 `query_data`，插件名是 `test_nested_plugin`
+- 调用时：`plugin: "python"`, `tool: "test_nested_plugin_query_data"`
+- 即：自动将 `插件名_工具名` 合并为 `tool` 参数
+
+**示例**：
+
+```javascript
+// 插件名: test-plugin, 工具名: hello
+ext_call({
+  plugin: 'python',
+  tool: 'test-plugin_hello',
+  args: { name: 'Foliko' },
+});
+
+// 插件名: test_nested_plugin, 工具名: query_data
+ext_call({
+  plugin: 'python',
+  tool: 'test_nested_plugin_query_data',
+  args: { filter: { name: 'Alice' } },
+});
+```
+
+## 概述
+
 ## 概述
 
 Python 插件允许用 Python 语言开发工具，插件代码运行在 Python 环境中，可以调用所有 Python 库。
@@ -101,14 +139,98 @@ def calc(params):
 
 ```javascript
 ext_call({
-  plugin: 'my-plugin', // 插件名称
-  tool: 'hello', // 工具名称
+  plugin: 'python', // 插件名称
+  tool: 'my-plugin_hello', // 工具名称
   args: { name: 'Foliko' }, // 工具参数
 });
 ```
 
 工具会自动出现在系统提示词的【Extensions 扩展工具】部分。
 
+## 嵌套参数支持
+
+`ext_call` 的 `args` 参数支持多层嵌套结构，可以传递复杂的数据对象：
+
+### 支持的参数类型
+
+| 类型     | 示例                                                | 说明           |
+| -------- | --------------------------------------------------- | -------------- |
+| 字符串   | `{"name": "Alice"}`                                 | 普通字符串参数 |
+| 数字     | `{"age": 25}`                                       | 数值参数       |
+| 布尔值   | `{"enabled": true}`                                 | 布尔参数       |
+| 数组     | `{"tags": ["a", "b"]}`                              | 数组参数       |
+| 嵌套对象 | `{"filter": {"name": "Alice"}}`                     | 对象内嵌对象   |
+| 深层嵌套 | `{"address": {"city": "Beijing", "zip": "100000"}}` | 多层嵌套       |
+
+### 调用示例
+
+```javascript
+// 简单参数
+ext_call({
+  plugin: 'python',
+  tool: 'my-plugin_query',
+  args: { table: 'users' },
+});
+
+// 嵌套 filter
+ext_call({
+  plugin: 'python',
+  tool: 'my-plugin_query_data',
+  args: {
+    filter: {
+      name: 'Alice',
+      age: 25,
+      tags: ['developer', 'python'],
+      address: {
+        city: 'Beijing',
+        zip: '100000',
+      },
+    },
+  },
+});
+
+// 带 options 的复杂查询
+ext_call({
+  plugin: 'python',
+  tool: 'my-plugin_query_data',
+  args: {
+    filter: { status: 'active' },
+    options: {
+      limit: 10,
+      sort: 'created_at',
+      order: 'desc',
+    },
+  },
+});
+```
+
+### Python 端接收
+
+```python
+def query_data(params):
+    # 访问顶层参数
+    filter_obj = params.get("filter", {})
+    options = params.get("options", {})
+
+    # 访问嵌套参数
+    name = filter_obj.get("name")
+    tags = filter_obj.get("tags", [])
+    city = filter_obj.get("address", {}).get("city")
+
+    # 访问深层嵌套
+    limit = options.get("limit", 100)
+    sort = options.get("sort", "id")
+
+    return {"success": True, "result": {...}}
+```
+
+### 注意事项
+
+1. **参数名简写**：`ext_call` 会将 `my-plugin_tool` 自动简写为 `my-plugin_xxx`
+2. **嵌套深度**：支持任意深度的嵌套对象
+3. **空值处理**：使用 `.get()` 方法并提供默认值，避免 KeyError
+4. **数组对象**：支持数组和嵌套对象的任意组合
+
 ## 示例：天气查询插件
 
 ```python