[Feature] Add Skills system, Skills-CLI management, and agent/tool integrations (#1001)

Co-authored-by: 陈家豪 <chenjiahao@60281493M.local>

Author: ChenJiahaoST

docs/en/API Reference/tools.md

@@ -339,6 +339,14 @@
     members:
     exclude-members: forward
 
+::: lazyllm.tools.LazyLLMAgentBase
+    members:
+    exclude-members: forward
+
+::: lazyllm.tools.SkillManager
+    members:
+    exclude-members: forward
+
 ::: lazyllm.tools.FunctionCall
     members:
     exclude-members: forward

docs/en/Best Practice/functionCall.md

@@ -129,6 +129,32 @@ print(f"ret: {ret}")
 
 In the above example, if the input query triggers a function call, [FunctionCall][lazyllm.tools.agent.FunctionCall] returns the assistant message dictionary that includes both `tool_calls` and `tool_calls_results`. [ReactAgent][lazyllm.tools.agent.ReactAgent] will re-invoke the model with the tool outputs until the model concludes that the information is sufficient or the number of iterations, controlled by `max_retries` (default 5), is exhausted.
 
+## Skills-aware agents
+
+All built-in agents (`ReactAgent`, `PlanAndSolveAgent`, `ReWOOAgent`) share the same base class and can enable **Skills** via the `skills` parameter. `skills=True` enables Skills with auto selection; pass a `str`/`list` to enable specific skills.
+
+```python
+import lazyllm
+from lazyllm.tools import ReactAgent
+
+llm = lazyllm.OnlineChatModule()
+agent = ReactAgent(
+    llm,
+    tools=["get_current_weather"],
+    skills=["docs-writer"],  # set skills=True to enable auto selection
+)
+```
+
+What changes when skills are enabled:
+- A skills guide prompt is automatically injected into the system prompt.
+- The agent can call skill tools: `get_skill`, `read_reference`, `run_script`.
+- A default toolset is auto-added for common operations (read/list/search/write/delete/move files, shell, download).
+
+Approval flow for risky operations:
+- Tools return `{"status": "needs_approval", ...}` for dangerous actions.
+- The front-end (or orchestrator) should ask for confirmation.
+- Re-run the tool with `allow_unsafe=True` only after explicit user approval.
+
 Complete code is as follows:
 ```python
 from typing import Literal

docs/zh/API Reference/tools.md

@@ -328,6 +328,14 @@
     members:
     exclude-members: forward
 
+::: lazyllm.tools.LazyLLMAgentBase
+    members:
+    exclude-members: forward
+
+::: lazyllm.tools.SkillManager
+    members:
+    exclude-members: forward
+
 ::: lazyllm.tools.FunctionCall
     members:
     exclude-members: forward

docs/zh/Best Practice/functionCall.md

@@ -126,6 +126,32 @@ print(f"ret: {ret}")
 
 在上面的例子中，如果输入的 query 触发了 function call，[FunctionCall][lazyllm.tools.agent.FunctionCall] 会返回包含 `tool_calls` 与 `tool_calls_results` 的助手消息字典。[ReactAgent][lazyllm.tools.agent.ReactAgent] 则会反复调用模型和工具，直到模型认定信息足以得出结论，或达到由 `max_retries`（默认 5）控制的最大迭代次数。
 
+## Skills 智能体支持
+
+所有内置 Agent（`ReactAgent`、`PlanAndSolveAgent`、`ReWOOAgent`）统一基于同一基类，可通过 `skills` 参数开启 Skills。`skills=True` 表示启用 Skills 并自动筛选；传入 `str`/`list` 表示只启用指定技能。
+
+```python
+import lazyllm
+from lazyllm.tools import ReactAgent
+
+llm = lazyllm.OnlineChatModule()
+agent = ReactAgent(
+    llm,
+    tools=["get_current_weather"],
+    skills=["docs-writer"],  # 传入 skills=True 启用自动筛选
+)
+```
+
+启用 Skills 后的变化：
+- 系统提示词自动拼接 Skills 引导。
+- 智能体可调用技能工具：`get_skill`、`read_reference`、`run_script`。
+- 默认注入一组通用工具（文件读写/检索、Shell 执行、下载等）。
+
+危险操作的审批流程：
+- 工具对高风险操作返回 `{"status": "needs_approval", ...}`。
+- 由前端/编排层进行用户确认。
+- 用户确认后再以 `allow_unsafe=True` 重新调用工具。
+
 完整代码如下：
 ```python
 from typing import Literal

examples/react_agent_with_skills.py

@@ -0,0 +1,53 @@
+import os
+import tempfile
+
+import lazyllm
+from lazyllm.tools import ReactAgent
+from lazyllm.tools.agent.skill_manager import SkillManager
+from lazyllm.cli.skills import skills as skills_cli
+
+
+def _prepare_sample_skill(root: str) -> str:
+    skill_dir = os.path.join(root, 'demo-skill')
+    os.makedirs(skill_dir, exist_ok=True)
+    skill_md = os.path.join(skill_dir, 'SKILL.md')
+    with open(skill_md, 'w', encoding='utf-8') as f:
+        f.write(
+            "---\n"
+            "name: demo-skill\n"
+            "description: A demo skill for showing how to import and use skills.\n"
+            "---\n"
+            "\n"
+            "# demo-skill\n"
+            "This is a minimal demo skill.\n"
+        )
+    return skill_dir
+
+
+def main():
+    # 1) Prepare a local skill folder and import it into the default skills directory
+    with tempfile.TemporaryDirectory() as tmp:
+        skill_dir = _prepare_sample_skill(tmp)
+        # CLI equivalents:
+        #   lazyllm skills init
+        #   lazyllm skills add /path/to/skill_folder
+        skills_cli(['init'])
+        skills_cli(['add', skill_dir])
+
+    # 2) Use SkillManager to show available skills
+    manager = SkillManager()
+    lazyllm.LOG.info(manager.list_skill())
+
+    # 3) Run ReactAgent with skills enabled
+    llm = lazyllm.TrainableModule('Qwen2.5-32B-Instruct')
+    agent = ReactAgent(
+        llm=llm,
+        tools=[],
+        skills=['demo-skill'],
+    )
+    res = agent('What skills do you have?')
+    lazyllm.LOG.info(res)
+
+
+if __name__ == '__main__':
+    main()

lazyllm/__init__.py

@@ -19,7 +19,7 @@
 from .hook import LazyLLMHook, LazyLLMFuncHook
 from typing import TYPE_CHECKING
 if TYPE_CHECKING:
-    from .tools import (Document, Reranker, Retriever, WebModule, ToolManager, FunctionCall,
+    from .tools import (Document, Reranker, Retriever, WebModule, ToolManager, FunctionCall, SkillManager,
                         FunctionCallAgent, fc_register, ReactAgent, PlanAndSolveAgent, ReWOOAgent, SentenceSplitter,
                         LLMParser)
 from .patch import patch_os_env
@@ -93,6 +93,7 @@ def __getattr__(name: str):
     'Retriever',
     'Reranker',
     'ToolManager',
+    'SkillManager',
     'FunctionCall',
     'FunctionCallAgent',
     'fc_register',

lazyllm/cli/main.py

@@ -4,7 +4,6 @@
     from deploy import deploy
     from run import run
     from skills import skills
-
 except ImportError:
     from .install import install
     from .deploy import deploy
@@ -16,7 +15,11 @@ def main():
     def exit():
         logging.error('Usage:\n  lazyllm install <extra1> <extra2> <pkg1> ...\n'
                       '  lazyllm deploy modelname\n  lazyllm deploy mcp_server <command> [args ...] [options]\n'
-                      '  lazyllm run graph.json\n  lazyllm run chatbot\n  lazyllm run rag\n')
+                      '  lazyllm run graph.json\n  lazyllm run chatbot\n  lazyllm run rag\n'
+                      '  lazyllm skills init\n  lazyllm skills list\n  lazyllm skills info <name>\n'
+                      '  lazyllm skills delete <name>\n  lazyllm skills add <path> [-n NAME] [--dir DIR]\n'
+                      '  lazyllm skills import <path> [--dir DIR] [--names a,b,c] [--overwrite]\n'
+                      '  lazyllm skills install --agent <name> [--project] [--timeout SEC]\n')
         sys.exit(1)
 
     if len(sys.argv) <= 1: exit()