Agent Scope Dev Skill — AI skill for Claude Code

AgentScope Java 2.0 开发指南（AI Agent Skill）

面向 **企业级、分布式、生产环境** 的 AgentScope Java 2.0 智能体框架开发技能包，为 AI 编码助手提供权威、可验证的开发指引。

[](LICENSE)

简体中文 | [English](README_EN.md)

---

项目简介

`agent-scope-dev` 是一个为 AI 编码 Agent（如 Claude Code / OpenCode / Codex 等）设计的中文技能包（Skill），完整覆盖 AgentScope Java 2.0 框架的**核心概念、开发模式、工程化部署与生产实践**。

技能包整合了三大知识来源，并强制在回答任何问题时**同时引用**，确保输出信息与真实源码一致：

1. 官方文档：AgentScope Java 2.0 官方在线文档
2. 框架源码：本地完整源码副本（source-code/agentscope-java-main/）
3. 离线参考：references/ 下的架构说明、API 细节与最佳实践

环境要求：JDK 17+，Maven 3.9+

---

功能特性

• ✅ 覆盖完整开发链路：Agent 开发 → HarnessAgent 工程化底座 → 模型集成 → Tool/MCP → 权限系统 → 沙箱/文件系统/记忆 → 多 Agent 编排 → 生产部署
• ✅ 源码级验证：内置 AgentScope Java 2.0 完整源码，查询时自动核对真实 API 签名与内部实现
• ✅ 中文本地化：全部参考文档为中文，降低阅读门槛
• ✅ 生产实践导向：包含单机→分布式迁移、常见坑位、V1→V2 迁移要点
• ✅ 离线可用：文档与源码全部本地化，不依赖网络

快速导航

场景	入口
初次使用	快速开始
构建基础 Agent	Agent 开发
工程化部署	HarnessAgent
模型接入	模型集成
工具开发	Tool 与 MCP
权限管控	权限系统
上生产环境	生产部署

完整目录见 [SKILL.md](SKILL.md)。

---

快速开始

1. 安装技能

将本仓库克隆或复制到你的 AI 编码助手技能目录（以 Claude Code 为例）：

# 方式一：直接克隆
git clone https://gitee.com/HillYoungGit/agent-scope-dev-skill.git \
  ~/.claude/skills/agent-scope-dev

# 方式二：GitHub
git clone https://github.com/HillYoungs/agent-scope-dev-skill.git \
  ~/.claude/skills/agent-scope-dev

不同 AI 助手的技能目录不同（如 OpenCode 为 `~/.config/opencode/skills/`），请按需调整。

2. 使用

在任何涉及 AgentScope Java 框架的对话中，直接向你的 AI 编码助手描述需求即可，技能会自动触发并遵循 `SKILL.md` 中的强制规则。

3. Maven 依赖（你的项目侧）

    io.agentscope
    agentscope-harness
    ${agentscope.version}




    io.agentscope
    agentscope-extensions-model-das