From 91e646632d205341952892053a73737395e97e74 Mon Sep 17 00:00:00 2001 From: Z User Date: Wed, 11 Feb 2026 20:44:49 +0000 Subject: [PATCH] Add comprehensive agents and skills documentation --- AGENTS_AND_SKILLS.md | 820 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 820 insertions(+) create mode 100644 AGENTS_AND_SKILLS.md diff --git a/AGENTS_AND_SKILLS.md b/AGENTS_AND_SKILLS.md new file mode 100644 index 0000000..20121c7 --- /dev/null +++ b/AGENTS_AND_SKILLS.md @@ -0,0 +1,820 @@ +# GLM Tools, Skills, and Agents Documentation + +This document provides a comprehensive overview of all agents, skills, and tools available in the Super Z system. + +--- + +## Table of Contents + +1. [Subagents (Task Tool)](#subagents-task-tool) +2. [Skills System](#skills-system) +3. [Tools Reference](#tools-reference) + +--- + +## Subagents (Task Tool) + +The Task tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it. + +### Agent Types + +#### 1. general-purpose + +**Description:** General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. Use this when you need to perform search for a keyword or file and are not confident that you will find the right match in the first few tries. + +**Tools Available:** All tools (*) + +**Use Cases:** +- Complex research questions +- Multi-step tasks requiring various tools +- Code searching across multiple files +- Open-ended exploration tasks + +--- + +#### 2. statusline-setup + +**Description:** Use this agent to configure the user's Claude Code status line setting. + +**Tools Available:** Read, Edit + +**Use Cases:** +- Status line configuration +- Settings management + +--- + +#### 3. Explore + +**Description:** Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (e.g., "src/components/**/*.tsx"), search code for keywords (e.g., "API endpoints"), or answer questions about the codebase (e.g., "how do API endpoints work?"). + +**Tools Available:** All tools + +**Thoroughness Levels:** +- **quick**: Basic searches +- **medium**: Moderate exploration +- **very thorough**: Comprehensive analysis across multiple locations and naming conventions + +**Use Cases:** +- Finding files by patterns +- Searching code for keywords +- Understanding codebase structure +- Answering questions about code architecture + +--- + +#### 4. Plan + +**Description:** Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. + +**Tools Available:** All tools + +**Use Cases:** +- Implementation planning +- Architecture design +- Identifying critical files +- Evaluating trade-offs + +--- + +#### 5. frontend-styling-expert + +**Description:** Use this agent when you need help with CSS, styling frameworks, responsive design, UI/UX implementation, animations, layout systems, or any visual/presentational aspects of web development. + +**Tools Available:** All tools + +**Example Use Cases:** +1. User: "I need to create a responsive navigation menu that collapses on mobile" → Use this agent to help design responsive navigation component +2. User: "The button hover effects aren't smooth enough" → Use this agent to optimize animations +3. User: "Can you help me center this div?" → Use this agent to provide the best centering solution +4. After writing HTML structure: Use this agent to add professional styling to components + +**Specialties:** +- CSS frameworks +- Responsive design +- UI/UX implementation +- Animations +- Layout systems +- Visual/presentational aspects + +--- + +#### 6. full-stack-developer + +**Description:** Full-stack Next.js 15 development agent that builds production-ready web applications with React, API routes, and Prisma databases. + +**Strongly Recommended For:** +- Building complete websites +- Creating data visualization dashboards +- Developing blog/CMS systems +- Implementing responsive web pages +- Integrating AI features (chat/image generation/web search) +- Real-time collaborative applications with WebSocket + +**Tools Available:** All tools + +**Key Strengths:** +- Frontend-first development approach +- Feature-complete modules combining UI components (shadcn/ui) +- Backend APIs +- Database operations +- Work documentation in /agent-ctx directory + +--- + +## Skills System + +Skills provide specialized capabilities and domain knowledge. Before starting any task, the system must follow a workflow to identify and invoke appropriate skills. + +### Available Skills + +#### 1. ASR (Automatic Speech Recognition) + +**Command:** `ASR` + +**Description:** Implement speech-to-text (ASR/automatic speech recognition) capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Transcribe audio files +- Convert speech to text +- Build voice input features +- Process audio recordings + +**Technical Details:** +- Supports base64 encoded audio files +- Returns accurate text transcriptions +- Uses z-ai-web-dev-sdk + +--- + +#### 2. LLM (Large Language Model) + +**Command:** `LLM` + +**Description:** Implement large language model (LLM) chat completions using the z-ai-web-dev-sdk. + +**Use Cases:** +- Build conversational AI applications +- Create chatbots +- Develop AI assistants +- Text generation features + +**Technical Details:** +- Supports multi-turn conversations +- System prompts +- Context management +- Uses z-ai-web-dev-sdk + +--- + +#### 3. TTS (Text-to-Speech) + +**Command:** `TTS` + +**Description:** Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Convert text into natural-sounding speech +- Create audio content +- Build voice-enabled applications +- Generate spoken audio files + +**Technical Details:** +- Supports multiple voices +- Adjustable speed +- Various audio formats +- Uses z-ai-web-dev-sdk + +--- + +#### 4. VLM (Vision Language Model) + +**Command:** `VLM` + +**Description:** Implement vision-based AI chat capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Analyze images +- Describe visual content +- Create applications combining image understanding with conversational AI + +**Technical Details:** +- Supports image URLs +- Supports base64 encoded images +- Multimodal interactions +- Uses z-ai-web-dev-sdk + +--- + +#### 5. csv-data-summarizer + +**Command:** `csv-data-summarizer` + +**Description:** Automatically analyzes CSV files with comprehensive statistical summaries, data quality checks, and intelligent visualizations. + +**Features:** +- Detects data types (sales, customer, financial, operational, survey) +- Adapts analysis accordingly +- Generates correlation heatmaps, time-series plots, distribution charts +- Categorical breakdowns +- Missing data analysis +- Automatic date column detection +- Industry-specific insights + +**Technical Details:** +- Built with pandas, matplotlib, and seaborn +- NO user prompting required - immediately runs full analysis +- Supports all relevant visualizations based on detected data patterns + +**Use Cases:** +- User uploads CSV +- Data analysis requests +- Dataset structure understanding + +--- + +#### 6. deep-research + +**Command:** `deep-research` + +**Description:** Conduct enterprise-grade research with multi-source synthesis, citation tracking, and verification. + +**Use Cases:** +- Comprehensive analysis requiring 10+ sources +- Verified claims +- Comparison of approaches +- Research reports +- Trend analysis + +**Triggers:** +- "deep research" +- "comprehensive analysis" +- "research report" +- "compare X vs Y" +- "analyze trends" + +**NOT For:** +- Simple lookups +- Debugging +- Questions answerable with 1-2 searches + +--- + +#### 7. docx + +**Command:** `docx` + +**Description:** Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. + +**Use Cases:** +1. Creating new documents +2. Modifying or editing content +3. Working with tracked changes +4. Adding comments +5. Any other document tasks + +**File Types:** .docx files + +--- + +#### 8. finance + +**Command:** `finance` + +**Description:** Comprehensive Finance API integration skill for real-time and historical financial data analysis, market research, and investment decision-making. + +**Priority Use Cases:** +- Stock price queries +- Market data analysis +- Company financial information +- Portfolio tracking +- Market news retrieval +- Stock screening +- Technical analysis +- Any financial market-related requests + +**Note:** This skill should be the primary choice for all Finance API interactions and financial data needs. + +--- + +#### 9. frontend-design + +**Command:** `frontend-design` + +**Description:** Transform UI style requirements into production-ready frontend code with systematic design tokens, accessibility compliance, and creative execution. + +**Use Cases:** +- Building websites +- Web applications +- React/Vue components +- Dashboards +- Landing pages +- Any web UI requiring design consistency and aesthetic quality + +--- + +#### 10. get-fortune-analysis + +**Command:** `get-fortune-analysis` + +**Description:** Fortune analysis skill for specialized use cases. + +--- + +#### 11. gift-evaluator + +**Command:** `gift-evaluator` + +**Description:** The PRIMARY tool for Spring Festival gift analysis and social interaction generation. + +**Use Cases:** +- Users upload photos of gifts (alcohol, tea, supplements, etc.) +- Inquire about gift value +- Authenticity verification +- Social response generation + +**Features:** +- Integrates visual perception +- Market valuation +- HTML card generation + +--- + +#### 12. image-edit + +**Command:** `image-edit` + +**Description:** Implement AI image editing and modification capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Edit existing images +- Create variations +- Modify visual content +- Redesign assets +- Transform images based on text descriptions + +**Technical Details:** +- Supports multiple image sizes +- Returns base64 encoded results +- Includes CLI tool for quick image editing +- Uses z-ai-web-dev-sdk + +--- + +#### 13. image-generation + +**Command:** `image-generation` + +**Description:** Implement AI image generation capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Create images from text descriptions +- Generate visual content +- Create artwork +- Design assets +- Build applications with AI-powered image creation + +**Technical Details:** +- Supports multiple image sizes +- Returns base64 encoded images +- Includes CLI tool for quick image generation +- Uses z-ai-web-dev-sdk + +**CLI Usage:** +```bash +# Generate image +z-ai-generate --prompt "A beautiful landscape" --output "./image.png" + +# Short form +z-ai-generate -p "A cute cat" -o "./cat.png" -s 1024x1024 +``` + +**Supported Sizes:** +- 1024x1024 +- 768x1344 +- 864x1152 +- 1344x768 +- 1152x864 +- 1440x720 +- 720x1440 + +--- + +#### 14. image-understand + +**Command:** `image-understand` + +**Description:** Implement specialized image understanding capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Analyze static images +- Extract visual information +- Perform OCR +- Detect objects +- Classify images +- Understand visual content + +**Supported Formats:** PNG, JPEG, GIF, WebP, BMP + +--- + +#### 15. pdf + +**Command:** `pdf` + +**Description:** Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. + +**Use Cases:** +- Fill in PDF forms +- Programmatically process PDFs +- Generate PDF documents +- Analyze PDF documents at scale + +--- + +#### 16. podcast-generate + +**Command:** `podcast-generate` + +**Description:** Generate podcast episodes from user-provided content or by searching the web for specified topics. + +**Modes:** +1. **User uploads text file/article:** Creates dual-host dialogue podcast (or single-host upon request) +2. **No content provided:** Searches web for information about user-specified topic and generates podcast + +**Features:** +- Duration scales with content size (3-20 minutes, ~240 chars/min) +- Uses z-ai-web-dev-sdk for LLM script generation and TTS audio synthesis +- Outputs podcast script (Markdown) and complete audio file (WAV) + +--- + +#### 17. pptx + +**Command:** `pptx` + +**Description:** Presentation editing, creation, and analysis. + +**Use Cases:** +1. Editing existing presentations +2. Adding slides to existing files +3. Creating new presentations +4. Working with layouts +5. Adding comments or speaker notes + +**File Types:** .pptx files + +--- + +#### 18. story-video-generation + +**Command:** `story-video-generation` + +**Description:** 根据用户输入的一句话，自动拓展为小故事，自动生成分场景图片，并将图片合成为视频。 + +**Triggers:** +- "生成故事" +- "故事视频" +- "把一句话变成视频" +- "制作故事视频" + +--- + +#### 19. video-generation + +**Command:** `video-generation` + +**Description:** Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Generate videos from text prompts or images +- Create video content programmatically +- Build applications that produce video outputs + +**Technical Details:** +- Supports asynchronous task management +- Status polling +- Result retrieval +- Uses z-ai-web-dev-sdk + +--- + +#### 20. video-understand + +**Command:** `video-understand` + +**Description:** Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Analyze video content +- Understand motion and temporal sequences +- Extract information from video frames +- Describe video scenes +- Perform video-based AI analysis + +**Supported Formats:** MP4, AVI, MOV, and other common video formats + +--- + +#### 21. web-reader + +**Command:** `web-reader` + +**Description:** Implement web page content extraction capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Scrape web pages +- Extract article content +- Retrieve page metadata +- Build applications that process web content + +**Features:** +- Automatic content extraction +- Title retrieval +- HTML retrieval +- Publication time retrieval + +--- + +#### 22. web-search + +**Command:** `web-search` + +**Description:** Implement web search capabilities using the z-ai-web-dev-sdk. + +**Use Cases:** +- Search for real-time information from the web +- Retrieve up-to-date content beyond knowledge cutoff +- Find latest news and data + +**Returns:** Structured search results with URLs, snippets, and metadata + +--- + +#### 23. xlsx + +**Command:** `xlsx` + +**Description:** Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. + +**Use Cases:** +1. Creating new spreadsheets with formulas and formatting +2. Reading or analyzing data +3. Modifying existing spreadsheets while preserving formulas +4. Data analysis and visualization in spreadsheets +5. Recalculating formulas + +**Supported Formats:** .xlsx, .xlsm, .csv, .tsv, etc. + +--- + +## Tools Reference + +### 1. Task Tool + +**Purpose:** Launch a new agent to handle complex, multi-step tasks autonomously. + +**Parameters:** +- `subagent_type` (Required): Type of specialized agent +- `prompt` (Required): Task for the agent to perform +- `description` (Optional): Short 3-5 word description +- `model` (Optional): Model to use (sonnet, opus, haiku) +- `resume` (Optional): Agent ID to resume from + +--- + +### 2. Bash Tool + +**Purpose:** Execute bash commands in a persistent shell session. + +**Parameters:** +- `command` (Required): Command to execute +- `description` (Optional): Description of the command +- `timeout` (Optional): Timeout in milliseconds (max 600000ms) + +--- + +### 3. Glob Tool + +**Purpose:** Fast file pattern matching tool. + +**Parameters:** +- `pattern` (Required): Glob pattern (e.g., "**/*.js") +- `path` (Optional): Directory to search (defaults to current) + +--- + +### 4. Grep Tool + +**Purpose:** Powerful search tool built on ripgrep. + +**Parameters:** +- `pattern` (Required): Regular expression pattern +- `path` (Optional): Directory to search +- `output_mode`: content, files_with_matches, count +- `glob`: File pattern filter +- `file_type`: File type filter (js, py, rust, go, java, etc.) +- `-A`, `-B`, `-C`: Context lines +- `-i`: Case insensitive +- `-n`: Show line numbers +- `multiline`: Enable multiline mode + +--- + +### 5. LS Tool + +**Purpose:** List files and directories. + +**Parameters:** +- `path` (Required): Absolute path to list +- `ignore`: Glob patterns to ignore + +--- + +### 6. Read Tool + +**Purpose:** Read files from the filesystem. + +**Parameters:** +- `filepath` (Required): Absolute path to the file +- `offset` (Optional): Starting line number +- `limit` (Optional): Number of lines to read + +--- + +### 7. Edit Tool + +**Purpose:** Perform exact string replacements in files. + +**Parameters:** +- `filepath` (Required): Absolute path +- `old_str` (Required): Text to replace +- `new_str` (Required): Replacement text +- `replace_all`: Replace all occurrences + +--- + +### 8. MultiEdit Tool + +**Purpose:** Multiple edits to a single file in one operation. + +**Parameters:** +- `filepath` (Required): Absolute path +- `edits` (Required): Array of edit operations + +--- + +### 9. Write Tool + +**Purpose:** Write a file to the filesystem. + +**Parameters:** +- `filepath` (Required): Absolute path +- `content` (Required): File content + +--- + +### 10. TodoWrite / TodoRead Tools + +**Purpose:** Manage task lists for coding sessions. + +**Parameters (TodoWrite):** +- `todos` (Required): Array of todo items with id, content, status, priority + +--- + +### 11. Skill Tool + +**Purpose:** Execute a skill within the main conversation. + +**Parameters:** +- `command` (Required): Skill name (no arguments) + +--- + +### 12. Complete Tool + +**Purpose:** Mark completion of code development or PPT creation tasks. + +**Parameters:** +- `project_type` (Required): Type of project ("web_dev") +- `summary` (Optional): Summary of completed project + +--- + +## SDK Integration (z-ai-web-dev-sdk) + +### Chat Completions Example + +```javascript +import ZAI from 'z-ai-web-dev-sdk'; + +async function main() { + try { + const zai = await ZAI.create() + + const completion = await zai.chat.completions.create({ + messages: [ + { + role: 'system', + content: 'You are a helpful assistant.' + }, + { + role: 'user', + content: 'Hello, who are you?' + } + ], + // Other parameters like temperature, max_tokens, etc. + }); + + const messageContent = completion.choices[0]?.message?.content; + console.log('Assistant says:', messageContent); + + } catch (error) { + console.error('An error occurred:', error.message); + } +} +``` + +### Image Generation Example + +```javascript +import ZAI from 'z-ai-web-dev-sdk'; + +async function generateImage() { + try { + const zai = await ZAI.create(); + + const response = await zai.images.generations.create({ + prompt: 'A cute cat playing in the garden', + size: '1024x1024' + }); + + const imageBase64 = response.data[0].base64; + console.log('Generated image base64:', imageBase64); + + } catch (error) { + console.error('Image generation failed:', error.message); + } +} +``` + +### Web Search Example + +```javascript +import ZAI from 'z-ai-web-dev-sdk'; + +async function testSearch() { + try { + const zai = await ZAI.create() + + const searchResult = await zai.functions.invoke("web_search", { + query: "What is the capital of France?", + num: 10 + }) + + console.log('Full API Response:', searchResult) + + } catch (error: any) { + console.error('An error occurred:', error.message); + } +} +``` + +### Search Result Type + +```typescript +interface SearchFunctionResultItem { + url: string; + name: string; + snippet: string; + host_name: string; + rank: number; + date: string; + favicon: string; +} +``` + +--- + +## Project Environment Notes + +- Next.js 15 with App Router +- Port: 3000 (auto dev server) +- `bun run dev` runs automatically - do not run manually +- Use `bun run lint` to check code quality +- z-ai-web-dev-sdk MUST be used in the backend only +- User can only see the / route defined in src/app/page.tsx + +--- + +## File Output Directory + +All generated files must be saved to: +``` +/home/z/my-project/download/ +``` + +--- + +*Document generated automatically from Super Z system configuration*