fix(agents): support optional claude agents

Author: liuxy0551

app/service/agents.js

@@ -292,15 +292,22 @@ class AgentsService extends Service {
 
         const name = this.validateAgentName(manifest.name);
         const version = manifest.version ? this.validateAgentVersion(manifest.version) : '';
-        const agents = Array.isArray(manifest.agents) ? manifest.agents : [];
-        if (agents.length === 0) {
-            this.ctx.throw(400, '.claude-plugin/plugin.json 必须声明 agents');
+
+        // agents 在 Claude Code 规范中为可选配置，支持单个路径字符串或路径数组
+        let agents = [];
+        if (typeof manifest.agents === 'string' && manifest.agents.trim()) {
+            agents = [this.normalizeManifestPath(manifest.agents, 'agents')];
+        } else if (Array.isArray(manifest.agents)) {
+            agents = manifest.agents
+                .map((item) => String(item || '').trim())
+                .filter(Boolean)
+                .map((item) => this.normalizeManifestPath(item, 'agents'));
         }
 
         return {
             name,
             version,
-            agents: agents.map((item) => this.normalizeManifestPath(item, 'agents')),
+            agents,
         };
     }
 

docs/docsify/zh-cn/guide/agent-market.md

@@ -207,7 +207,7 @@ Doraemon 采用 GitOps 模式管理 Agent 插件，实现代码集中在 GitLab
    - 检查根目录下 `.codex-plugin/plugin.json` 与 `.claude-plugin/plugin.json` 是否齐全。
    - 校验 Manifest 中的 `name` 必须与 GitLab 仓库名（去除 `.git` 后缀）完全一致。
    - 校验两个 Manifest 中的 `version` 核心版本号必须完全一致。
-   - 校验 `skills` 声明的目录及 Claude `agents` 引用的角色文件真实存在。
+   - 校验 `skills` 声明的目录是否存在（若声明了 Claude `agents` 路径则校验其路径格式合法性）。
 4. **精确版本追踪（Content Hash）**：
    - 执行 `git rev-parse HEAD` 获取当前分支最新提交的 Commit SHA 作为 `content_hash`。
    - 数据库分别维护：
@@ -361,7 +361,7 @@ bugfix-agent
 ```
 
 - `name`：必须与 `.codex-plugin/plugin.json` 的 `name` 严格保持一致。
-- `agents`：必须声明角色定义文件相对路径列表，引用的文件在仓库内必须真实存在。
+- `agents`：可选。若包含 Claude Code 角色定义，可声明角色文件或目录的相对路径（支持字符串如 `"./agents/claude"` 或文件列表数组如 `["./agents/claude/bugfix-worker.md"]`；若无需自定义 subagents 可省略或留空）。
 
 ## 服务端配置说明
 

test/agent-plugin-contract.test.js

@@ -104,11 +104,50 @@ test('validateCodexManifest 支持最多 1024 字符的多行代码块 defaultPr
     );
 });
 
-test('validateClaudeManifest 校验 agents 配置有效性', () => {
+test('validateClaudeManifest 支持 agents 为可选配置，并兼容字符串或数组格式', () => {
     const service = createService();
+
+    // 1. 省略 agents 或传空数组正常通过
+    assert.deepEqual(service.validateClaudeManifest({ name: 'bugfix-agent' }).agents, []);
+    assert.deepEqual(
+        service.validateClaudeManifest({ name: 'bugfix-agent', agents: [] }).agents,
+        []
+    );
+    assert.deepEqual(
+        service.validateClaudeManifest({ name: 'bugfix-agent', agents: '' }).agents,
+        []
+    );
+
+    // 2. 支持单个字符串路径
+    assert.deepEqual(
+        service.validateClaudeManifest({
+            name: 'bugfix-agent',
+            agents: './agents/claude',
+        }).agents,
+        ['agents/claude']
+    );
+
+    // 3. 支持数组格式路径列表
+    assert.deepEqual(
+        service.validateClaudeManifest({
+            name: 'bugfix-agent',
+            agents: ['./agents/claude/worker.md', './agents/claude/reviewer.md'],
+        }).agents,
+        ['agents/claude/worker.md', 'agents/claude/reviewer.md']
+    );
+
+    // 4. 非法相对路径（非 ./ 开头）仍应拦截
+    assert.throws(
+        () => service.validateClaudeManifest({ name: 'bugfix-agent', agents: 'invalid/path' }),
+        /agents 必须是 \.\/ 开头的相对路径/
+    );
     assert.throws(
-        () => service.validateClaudeManifest({ name: 'bugfix-agent', agents: [] }),
-        /\.claude-plugin\/plugin\.json 必须声明 agents/
+        () =>
+            service.validateClaudeManifest({
+                name: 'bugfix-agent',
+                agents: ['invalid/path'],
+            }),
+        /agents 必须是 \.\/ 开头的相对路径/
     );
 });