presets:
  - id: research-agent
    version: 1
    scenario: research
    icon: search
    tags:
      - research
      - knowledge
    runtime_hints:
      suggested_name: research-agent
    attachments:
      - type: memory
        name: Research memory
        description: Create an isolated memory space for long-term research preferences and confirmed findings.
        required: false
        realization: create
    locales:
      zh-CN:
        name: 研究助手
        description: 适合持续检索资料、整理引用并输出结构化研究结论的智能体角色。
        attachments:
          - type: memory
            name: 研究记忆
            description: 为该智能体创建独立记忆空间，记录长期研究偏好和已确认结论。
            required: false
            realization: create
        definition_path: assets/roles/definitions/research-agent/zh-CN/IDENTITY.md
      en-US:
        name: Research Assistant
        description: A role for gathering evidence, citing sources, and turning research into structured conclusions.
        definition_path: assets/roles/definitions/research-agent/en-US/IDENTITY.md
  - id: general-purpose
    version: 1
    scenario: general
    icon: sparkles
    tags:
      - fullstack
      - implementation
    runtime_hints:
      suggested_name: general-purpose
    locales:
      zh-CN:
        name: 通用开发助手
        description: 适合从 UI 到后端串联完整产品路径的全栈开发角色。
        definition_path: assets/roles/definitions/general-purpose/zh-CN/IDENTITY.md
      en-US:
        name: General Purpose
        description: Fullstack development from UI to backend.
        definition_path: assets/roles/definitions/general-purpose/en-US/IDENTITY.md
  - id: backend-developer
    version: 1
    scenario: backend-development
    icon: server
    tags:
      - backend
      - implementation
    runtime_hints:
      suggested_name: backend-developer
    locales:
      zh-CN:
        name: 后端开发助手
        description: 适合处理服务端数据、权限、事务和失败路径完整性的角色。
        definition_path: assets/roles/definitions/backend-developer/zh-CN/IDENTITY.md
      en-US:
        name: Backend Developer
        description: Server-side development with data, auth, and failure-path integrity.
        definition_path: assets/roles/definitions/backend-developer/en-US/IDENTITY.md
  - id: frontend-developer
    version: 1
    scenario: frontend-development
    icon: monitor
    tags:
      - frontend
      - ui
    runtime_hints:
      suggested_name: frontend-developer
    attachments:
      - type: skill
        library_slug: addy-agent-skills
        skill_slug: frontend-ui-engineering
        realization: copy
        required: false
      - type: skill
        library_slug: addy-agent-skills
        skill_slug: browser-testing-with-devtools
        realization: copy
        required: false
    locales:
      zh-CN:
        name: 前端开发助手
        description: 适合处理 UI 组件、状态管理和用户可见行为的角色。
        definition_path: assets/roles/definitions/frontend-developer/zh-CN/IDENTITY.md
      en-US:
        name: Frontend Developer
        description: UI components, state management, and user-visible behavior.
        definition_path: assets/roles/definitions/frontend-developer/en-US/IDENTITY.md
  - id: code-reviewer
    version: 1
    scenario: code-review
    icon: code
    tags:
      - code
      - review
    runtime_hints:
      suggested_name: code-reviewer
    locales:
      zh-CN:
        name: 代码评审助手
        description: 适合审查实现方案、找出 correctness / performance / boundary 风险的智能体角色。
        definition_path: assets/roles/definitions/code-reviewer/zh-CN/IDENTITY.md
      en-US:
        name: Code Reviewer
        description: A role for reviewing implementation plans and code for correctness, performance, boundaries, and missing tests.
        definition_path: assets/roles/definitions/code-reviewer/en-US/IDENTITY.md
  - id: debugger
    version: 1
    scenario: debugging
    icon: bug
    tags:
      - debugging
      - diagnosis
    runtime_hints:
      suggested_name: debugger
    locales:
      zh-CN:
        name: 调试助手
        description: 适合用证据驱动方式定位失败根因的角色。
        definition_path: assets/roles/definitions/debugger/zh-CN/IDENTITY.md
      en-US:
        name: Debugger
        description: Root-cause isolation through evidence-driven failure analysis.
        definition_path: assets/roles/definitions/debugger/en-US/IDENTITY.md
  - id: devops-engineer
    version: 1
    scenario: devops
    icon: terminal
    tags:
      - devops
      - operations
    runtime_hints:
      suggested_name: devops-engineer
    locales:
      zh-CN:
        name: DevOps 助手
        description: 适合处理生产安全、CI/CD 和运维可靠性的角色。
        definition_path: assets/roles/definitions/devops-engineer/zh-CN/IDENTITY.md
      en-US:
        name: DevOps Engineer
        description: Production safety, CI/CD, and operational reliability.
        definition_path: assets/roles/definitions/devops-engineer/en-US/IDENTITY.md
  - id: qa-engineer
    version: 1
    scenario: qa
    icon: check-circle
    tags:
      - qa
      - testing
    runtime_hints:
      suggested_name: qa-engineer
    locales:
      zh-CN:
        name: QA 助手
        description: 适合做风险驱动测试规划和发布质量把关的角色。
        definition_path: assets/roles/definitions/qa-engineer/zh-CN/IDENTITY.md
      en-US:
        name: QA Engineer
        description: Risk-based test planning and release quality gating.
        definition_path: assets/roles/definitions/qa-engineer/en-US/IDENTITY.md
  - id: testing-assistant
    version: 1
    scenario: testing
    icon: clipboard-list
    tags:
      - testing
      - test-cases
      - validation
    runtime_hints:
      suggested_name: testing-assistant
    locales:
      zh-CN:
        name: 测试助手
        description: 适合分析需求可测性、设计并执行测试、复现缺陷和反馈测试结果的角色。
        definition_path: assets/roles/definitions/testing-assistant/zh-CN/IDENTITY.md
      en-US:
        name: Testing Assistant
        description: A role for testability analysis, test design and execution, defect reproduction, and test result reporting.
        definition_path: assets/roles/definitions/testing-assistant/en-US/IDENTITY.md
  - id: security-auditor
    version: 1
    scenario: security
    icon: shield
    tags:
      - security
      - audit
    runtime_hints:
      suggested_name: security-auditor
    locales:
      zh-CN:
        name: 安全审计助手
        description: 适合审查应用和基础设施安全风险的角色。
        definition_path: assets/roles/definitions/security-auditor/zh-CN/IDENTITY.md
      en-US:
        name: Security Auditor
        description: Application and infrastructure security auditing.
        definition_path: assets/roles/definitions/security-auditor/en-US/IDENTITY.md
  - id: product-manager
    version: 1
    scenario: product-management
    icon: briefcase
    tags:
      - product
      - requirements
      - prioritization
    runtime_hints:
      suggested_name: product-manager
    locales:
      zh-CN:
        name: 产品经理助手
        description: 适合澄清用户问题、拆解需求、整理优先级和验收标准的角色。
        definition_path: assets/roles/definitions/product-manager/zh-CN/IDENTITY.md
      en-US:
        name: Product Manager
        description: A role for clarifying user problems, shaping requirements, prioritizing scope, and defining acceptance criteria.
        definition_path: assets/roles/definitions/product-manager/en-US/IDENTITY.md
  - id: technical-writer
    version: 1
    scenario: technical-writing
    icon: file-text
    tags:
      - documentation
      - writing
      - technical-writing
    runtime_hints:
      suggested_name: technical-writer
    locales:
      zh-CN:
        name: 技术写作助手
        description: 适合把复杂技术内容转成清晰、可维护、面向读者的文档。
        definition_path: assets/roles/definitions/technical-writer/zh-CN/IDENTITY.md
      en-US:
        name: Technical Writer
        description: A role for turning complex technical material into clear, maintainable, reader-oriented documentation.
        definition_path: assets/roles/definitions/technical-writer/en-US/IDENTITY.md
  - id: marketing-strategist
    version: 1
    scenario: marketing
    icon: megaphone
    tags:
      - marketing
      - positioning
      - campaigns
    runtime_hints:
      suggested_name: marketing-strategist
    locales:
      zh-CN:
        name: 营销策略助手
        description: 适合定位受众、打磨信息、规划活动和输出可执行营销素材的角色。
        definition_path: assets/roles/definitions/marketing-strategist/zh-CN/IDENTITY.md
      en-US:
        name: Marketing Strategist
        description: A role for audience positioning, messaging, campaign planning, and practical marketing deliverables.
        definition_path: assets/roles/definitions/marketing-strategist/en-US/IDENTITY.md
  - id: customer-support-specialist
    version: 1
    scenario: customer-support
    icon: headphones
    tags:
      - support
      - customer
      - knowledge-base
    runtime_hints:
      suggested_name: customer-support-specialist
    locales:
      zh-CN:
        name: 客户支持助手
        description: 适合分析客户问题、整理回复、升级线索并沉淀支持知识的角色。
        definition_path: assets/roles/definitions/customer-support-specialist/zh-CN/IDENTITY.md
      en-US:
        name: Customer Support Specialist
        description: A role for analyzing customer issues, drafting responses, escalating signals, and improving support knowledge.
        definition_path: assets/roles/definitions/customer-support-specialist/en-US/IDENTITY.md
  - id: data-analyst
    version: 1
    scenario: data-analysis
    icon: chart
    tags:
      - data
      - analytics
      - metrics
    runtime_hints:
      suggested_name: data-analyst
    locales:
      zh-CN:
        name: 数据分析助手
        description: 适合把业务问题转成指标、分析计划、洞察和决策建议的角色。
        definition_path: assets/roles/definitions/data-analyst/zh-CN/IDENTITY.md
      en-US:
        name: Data Analyst
        description: A role for turning business questions into metrics, analysis plans, insights, and decision recommendations.
        definition_path: assets/roles/definitions/data-analyst/en-US/IDENTITY.md
  - id: ux-designer
    version: 1
    scenario: ux-design
    icon: palette
    tags:
      - design
      - ux
      - interaction
    runtime_hints:
      suggested_name: ux-designer
    locales:
      zh-CN:
        name: UX 设计助手
        description: 适合梳理用户流程、信息架构、交互状态和设计评审的角色。
        definition_path: assets/roles/definitions/ux-designer/zh-CN/IDENTITY.md
      en-US:
        name: UX Designer
        description: A role for user flows, information architecture, interaction states, and design review.
        definition_path: assets/roles/definitions/ux-designer/en-US/IDENTITY.md
  - id: sales-solutions-consultant
    version: 1
    scenario: sales
    icon: handshake
    tags:
      - sales
      - solutions
      - customer-discovery
    runtime_hints:
      suggested_name: sales-solutions-consultant
    locales:
      zh-CN:
        name: 销售方案助手
        description: 适合整理客户需求、匹配产品能力、准备方案和跟进材料的角色。
        definition_path: assets/roles/definitions/sales-solutions-consultant/zh-CN/IDENTITY.md
      en-US:
        name: Sales Solutions Consultant
        description: A role for customer discovery, capability mapping, solution proposals, and follow-up material.
        definition_path: assets/roles/definitions/sales-solutions-consultant/en-US/IDENTITY.md
  - id: project-coordinator
    version: 1
    scenario: project-coordination
    icon: clipboard-list
    tags:
      - coordination
      - project
      - planning
    runtime_hints:
      suggested_name: project-coordinator
    locales:
      zh-CN:
        name: 项目协调助手
        description: 适合跟踪任务、会议结论、依赖、风险和跨团队行动项的角色。
        definition_path: assets/roles/definitions/project-coordinator/zh-CN/IDENTITY.md
      en-US:
        name: Project Coordinator
        description: A role for tracking tasks, meeting decisions, dependencies, risks, and cross-team action items.
        definition_path: assets/roles/definitions/project-coordinator/en-US/IDENTITY.md
  - id: people-ops-partner
    version: 1
    scenario: people-ops
    icon: users
    tags:
      - people
      - hr
      - operations
    runtime_hints:
      suggested_name: people-ops-partner
    locales:
      zh-CN:
        name: 人力与组织助手
        description: 适合整理招聘、绩效、团队沟通和员工体验方案的角色。
        definition_path: assets/roles/definitions/people-ops-partner/zh-CN/IDENTITY.md
      en-US:
        name: People Ops Partner
        description: A role for recruiting, performance, team communication, and employee experience workflows.
        definition_path: assets/roles/definitions/people-ops-partner/en-US/IDENTITY.md
  - id: finance-analyst
    version: 1
    scenario: finance
    icon: wallet
    tags:
      - finance
      - planning
      - analysis
    runtime_hints:
      suggested_name: finance-analyst
    locales:
      zh-CN:
        name: 财务分析助手
        description: 适合预算、预测、成本分析和经营指标解释的角色。
        definition_path: assets/roles/definitions/finance-analyst/zh-CN/IDENTITY.md
      en-US:
        name: Finance Analyst
        description: A role for budgeting, forecasting, cost analysis, and operating metric interpretation.
        definition_path: assets/roles/definitions/finance-analyst/en-US/IDENTITY.md
  - id: legal-compliance-advisor
    version: 1
    scenario: legal-compliance
    icon: scale
    tags:
      - legal
      - compliance
      - risk
    runtime_hints:
      suggested_name: legal-compliance-advisor
    locales:
      zh-CN:
        name: 法务合规助手
        description: 适合初步梳理合同、政策、合规义务和风险升级点的角色。
        definition_path: assets/roles/definitions/legal-compliance-advisor/zh-CN/IDENTITY.md
      en-US:
        name: Legal Compliance Advisor
        description: A role for first-pass contract, policy, compliance obligation, and risk escalation review.
        definition_path: assets/roles/definitions/legal-compliance-advisor/en-US/IDENTITY.md
  - id: operations-manager
    version: 1
    scenario: operations
    icon: workflow
    tags:
      - operations
      - process
      - execution
    runtime_hints:
      suggested_name: operations-manager
    locales:
      zh-CN:
        name: 运营管理助手
        description: 适合梳理流程、指标、跨团队执行和运营改进的角色。
        definition_path: assets/roles/definitions/operations-manager/zh-CN/IDENTITY.md
      en-US:
        name: Operations Manager
        description: A role for process design, operating metrics, cross-functional execution, and operational improvement.
        definition_path: assets/roles/definitions/operations-manager/en-US/IDENTITY.md