feat: Add ZCode integration for agency-agents

[zhang417677318]

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.