ok Merge branch 'main' of github.com:modelscope/ms-agent into release/1.6

Author: wangxingjun778

README.md

@@ -41,6 +41,7 @@ MS-Agent is a lightweight framework designed to empower agents with autonomous e
 - **Code Generation**: Supports code generation tasks with artifacts.
 - **Short Video Generation**：Support video generation of about 5 minutes.
 - **Agent Skills**: Implementation of [Anthropic-Agent-Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) Protocol.
+- **WebUI**: Modern web interface for agent interaction with real-time WebSocket communication.
 - **Lightweight and Extensible**: Easy to extend and customize for various applications.
 
 
@@ -262,6 +263,58 @@ asyncio.run(main())
 </details>
 
 
+### Agent Skills
+
+**MS-Agent Skills** is an **Implementation** of the [**Anthropic-Agent-Skills**](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) protocol, enabling agents to autonomously explore and execute complex tasks by leveraging predefined or custom "skills".
+
+
+#### Key Features
+
+- 📜 **Standard Skill Protocol**: Fully compatible with the [Anthropic Skills](https://github.com/anthropics/skills) protocol
+- 🧠 **Heuristic Context Loading**: Loads only necessary context—such as `References`, `Resources`, and `Scripts` on demand
+- 🤖 **Autonomous Execution**: Agents autonomously analyze, plan, and decide which scripts and resources to execute based on skill definitions
+- 🔍 **Skill Management**: Supports batch loading of skills and can automatically retrieve and discover relevant skills based on user input
+- 🛡️ **Code Execution Environment**: Optional local direct code execution or secure sandboxed execution via [**ms-enclave**](https://github.com/modelscope/ms-enclave), with automatic dependency installation and environment isolation
+- 📁 **Multi-file Type Support**: Supports documentation, scripts, and resource files
+- 🧩 **Extensible Design**: The skill data structure is modularized, with implementations such as `SkillSchema` and `SkillContext` provided for easy extension and customization
+
+
+#### Quick Start
+
+> 💡 Note:
+> 1. Before running the following examples, ensure that you have set the `OPENAI_API_KEY` and `OPENAI_BASE_URL` environment variables to access the required model APIs.
+> 2. Agent Skills requires ms-agent >= 1.4.0
+
+
+**Installation**:
+
+```shell
+pip install ms-agent
+```
+
+**Usage**:
+
+> This example demonstrates how to configure and run an Agent Skill that generates generative art code based on p5.js flow fields.
+
+
+Refer to: [Run Skills](projects/agent_skills/run.py)
+
+
+**Result**:
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/9d5d78bf-c2db-4280-b780-324eab74a41e" alt="FlowFieldParticles" width="750">
+  <p><em>Agent-Skills: Flow Field Particles</em></p>
+</div>
+
+
+#### References
+- **README**: [MS-Agent Skills](projects/agent_skills/README.md)
+- **Anthropic Agent Skills Official Docs**: [Anthropic-Agent-Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills)
+- **Anthropic Skills GitHub Repo**: [Skills](https://github.com/anthropics/skills)
+
+
+
 ### Agentic Insight
 
 #### - Lightweight, Efficient, and Extensible Multi-modal Deep Research Framework
@@ -340,36 +393,40 @@ For more details, refer to [Doc Research](projects/doc_research/README.md)
 
 <br>
 
-### Code Scratch
+### Code Genesis
 
-This project provides a framework for **Code Scratch**, enabling agents to autonomously generate code projects.
+**Code Genesis** is a production-ready multi-agent framework that orchestrates specialized AI agents to autonomously generate complete software projects from natural language requirements.
 
 #### Features
 
-  - 🎯 **Complex Code Generation** - Support for complex code generation tasks, especially React frontend and Node.js backend
-  - 🔧 **Customizable Workflows** - Enable users to freely develop their own code generation workflows tailored to specific scenarios
-  - 🏗️ **Three-Phase Architecture** - Design & Coding Phase followed by Refine Phase for robust code generation and error fixing
-  - 📁 **Intelligent File Grouping** - Automatically groups related code files to minimize dependencies and reduce bugs
-  - 🔄 **Auto Compilation & Fixing** - Automatic npm compilation with intelligent error analysis and iterative fixing
+  - 🎯 **End-to-End Project Generation** - From requirement analysis to deployment-ready artifacts with minimal human intervention
+  - 🔧 **Dual Workflow Modes** - Standard 7-agent pipeline for production systems, or streamlined 4-agent mode for rapid prototyping
+  - 🏗️ **Topology-Aware Code Generation** - Dependency-driven scheduling eliminates hallucinated imports and enables parallel generation
+  - 📁 **LSP-Integrated Validation** - Real-time Language Server Protocol checks ensure syntactic correctness and import resolution
+  - 🔄 **Self-Healing Refinement** - Automated runtime verification and deployment
 
 #### Demo
 
-**AI Workspace Homepage**
+**Homepage**
 
-Generate a complete ai workspace homepage with the following command:
+Generate a complete homepage with the following command:
 
 ```shell
-PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_genesis --query 'Build a comprehensive AI workspace homepage' --trust_remote_code true
+PYTHONPATH=. openai_api_key=your-api-key openai_base_url=your-api-url python ms_agent/cli/cli.py run --config projects/code_genesis --query 'Build a static site to display skills, projects, and contact info' --trust_remote_code true
 ```
 
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/841fd06e-3611-4b27-86e0-4881963639bd" img width="2940" height="1670" alt="LocalGradioApplication" width="750">
+  <p><em>Demo: Homepage</em></p>
+</div>
+
 The generated code will be output to the `output` folder in the current directory.
 
 **Architecture Workflow:**
-- **Design Phase**: Analyze requirements → Generate PRD & module design → Create implementation tasks
-- **Coding Phase**: Execute coding tasks in intelligent file groups → Generate complete code structure
-- **Refine Phase**: Auto-compilation → Error analysis → Iterative bug fixing → Human evaluation loop
+- **Standard Pipeline** (7 agents): User Story → Architect → File Design → File Order → Install → Coding → Refine
+- **Simple Pipeline** (4 agents): Orchestrator → Install → Coding → Refine
 
-For more details, refer to [Code Scratch](projects/code_genesis/README.md).
+For more details, refer to [Code Genesis](projects/code_genesis/pr_article.md).
 
 <br>
 
@@ -438,6 +495,50 @@ aggregator:
 - README: [FinResearch](projects/fin_research/README.md)
 - Documentation: [MS-Agent Documentation](https://ms-agent-en.readthedocs.io/en/latest/Projects/FinResearch.html)
 
+### WebUI
+
+MS-Agent provides a modern web interface for interacting with agents. Built with React frontend and FastAPI backend, featuring real-time WebSocket communication.
+
+#### Demo
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/62026584-6c96-4a84-a849-05ae49906f48" alt="LocalGradioApplication" width="750">
+  <p><em>Demo: WebUI</em></p>
+</div>
+
+#### Quick Start
+
+**Start WebUI:**
+
+```bash
+ms-agent ui
+```
+
+The browser will automatically open at http://localhost:7860
+
+**Command Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--host` | Server host | 0.0.0.0 |
+| `--port` | Server port | 7860 |
+| `--production` | Production mode | False |
+| `--no-browser` | Don't auto-open browser | False |
+| `--reload` | Enable auto-reload (dev) | False |
+
+**Examples:**
+
+```bash
+# Custom port
+ms-agent ui --port 8080
+
+# Production mode without auto browser
+ms-agent ui --production --no-browser
+```
+
+
+<br>
+
 ### Singularity Cinema
 
 Singularity Cinema is an Agent-powered workflow for generating short videos, capable of producing high-quality complex short videos using either a single-sentence prompt or knowledge-based documents.