Skip to content

feat: Add ZCode integration for agency-agents#619

Open
zhang417677318 wants to merge 1 commit into
msitarzewski:mainfrom
zhang417677318:add-zcode-integration
Open

feat: Add ZCode integration for agency-agents#619
zhang417677318 wants to merge 1 commit into
msitarzewski:mainfrom
zhang417677318:add-zcode-integration

Conversation

@zhang417677318

Copy link
Copy Markdown

Summary

This PR adds full support for ZCode — a popular AI coding assistant with a semantic skill-triggering system. ZCode automatically selects the most appropriate agent based on the description field in each skill's SKILL.md file, making it ideal for the agency-agents workflow.

What This PR Includes

1. Core Integration Files

  • integrations/zcode/README.md — Complete documentation covering:

    • How ZCode's semantic skill triggering works
    • Installation instructions (user-scoped and project-scoped)
    • Regeneration workflow
    • Differences from other tool integrations
  • integrations/zcode/skills/*/ — 218 converted agent personalities as ZCode skills

    • Each skill follows ZCode's skills/<name>/SKILL.md format
    • YAML frontmatter contains name and description (the primary trigger signal)
    • Body contains the full agent personality and instructions
    • Descriptions include both English and Chinese keywords for better trigger coverage

2. Build System Integration

  • scripts/convert.sh — Added convert_zcode() function
  • tools.json — Added ZCode tool entry with format/dest config
  • scripts/install.sh — Added ZCode detection and installation

3. Windows Support

  • scripts/convert_zcode.py — Python cross-platform conversion script (works on all OSes)

How ZCode Skill Triggering Works

ZCode uses semantic matching on the description field to automatically trigger the right skill:

User Request Triggered Skill
"帮我设计一个高并发系统的后端架构" backend-architect
"帮我开发一个响应式的前端页面" frontend-developer
"帮我搭建 CI/CD 流水线" devops-automator
"帮我写抖音运营策略" douyin-strategist

No manual @ mention required — ZCode automatically selects the best skill based on context.

Key Design Decisions

  1. Broad Triggering: Descriptions include both English and Chinese keywords
  2. English Body: Agent personalities remain in English (as in original)
  3. Dual Installation Paths: Supports both ~/.zcode/skills/ and ./.zcode/skills/
  4. Cross-Platform: Python conversion script works on Windows, macOS, and Linux

Testing

  • ✅ 218 agents successfully converted to ZCode skill format
  • ✅ All skills install correctly to ~/.zcode/skills/
  • ✅ Description optimization verified for key development roles
  • ✅ Semantic triggering tested with Chinese keywords

Related

This integration enables Windows users (who cannot use glas.sh or brew-browser) to fully utilize agency-agents through ZCode's cross-platform skill system.

Add ZCode integration for agency-agents

- Add ZCode skill format converter (convert_zcode)
- Add 218 agent personalities as ZCode skills
- Add Chinese keywords to descriptions for better trigger coverage
- Add ZCode tool entry to tools.json
- Add ZCode detection and installation to install.sh
- Add Python cross-platform conversion script
- Add comprehensive README documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant