技能与自定义智能体

A3S Code 不再内置默认 skills。请从磁盘上的目录加载自己的技能和子智能体来扩展会话。使用 skillDirs 加载 Markdown skills，使用 agentDirs 加载 worker/subagent 定义。 registerAgentDir 可以在 session 创建后继续追加 agent 定义目录；skill 目录在 session 创建时加载。

Rust

Node.js

Python

Rust

use a3s_code_core::{Agent, SessionOptions};
use std::path::Path;

#[tokio::main]
async fn main() -> a3s_code_core::Result<()> {
    let agent = Agent::new("agent.acl").await?;
    let session = agent
        .session_builder("/path/to/project")
        .options(
            SessionOptions::new()
                .with_skill_dirs(["./.a3s/skills"])
                .with_agent_dir("./.a3s/agents"),
        )
        .build()
        .await?;

    session.register_agent_dir(Path::new("./team/shared-agents"))?;
    println!("工具：{:?}", session.tool_names());
    println!("技能：{:?}", session.skill_names());

    let result = session
        .send("使用项目约定技能搭建一个新模块。", None)
        .await?;
    println!("{}", result.text);

    session.close().await;
    agent.close().await;
    Ok(())
}

TypeScript

import { Agent } from '@a3s-lab/code';

const agent = await Agent.create('agent.acl');

// 显式加载项目 skills 和 agents。
const session = agent.session('/path/to/project', {
  skillDirs: ['./.a3s/skills'],
  agentDirs: ['./.a3s/agents'],
});

// 会话创建后可以继续注册智能体定义目录。
session.registerAgentDir('./team/shared-agents');

// 查看会话已加载的内容。
console.log('Tools:', session.toolNames());
console.log('Skills:', session.skillNames());

// 智能体现在可以使用项目技能。
const result = await session.run(
  'Use the project conventions skill to scaffold a new module.',
);
console.log(result.text);

session.close();

Python

from a3s_code import Agent, SessionOptions

agent = Agent.create("agent.acl")

# 显式加载项目 skills 和 agents。
opts = SessionOptions()
opts.skill_dirs = ['./.a3s/skills']
opts.agent_dirs = ['./.a3s/agents']

session = agent.session('/path/to/project', opts)

# 会话创建后可以继续注册智能体定义目录。
session.register_agent_dir('./team/shared-agents')

# 查看会话已加载的内容。
print('Tools:', session.tool_names())
print('Skills:', session.skill_names())

# 智能体现在可以使用项目技能。
result = session.run(
    'Use the project conventions skill to scaffold a new module.',
)
print(result.text)

session.close()

package main

import (
	"context"
	"fmt"
	"log"

	code "github.com/A3S-Lab/Code/sdk/go/v9"
)

func main() {
	ctx := context.Background()
	agent, err := code.Create(ctx, "agent.acl")
	if err != nil {
		log.Fatal(err)
	}
	defer agent.Close(context.Background())
	session, err := agent.Session(ctx, "/path/to/project", &code.SessionOptions{
		SkillDirs: []string{"./.a3s/skills"},
		AgentDirs: []string{"./.a3s/agents"},
	})
	if err != nil {
		log.Fatal(err)
	}
	defer session.Close(context.Background())

	if _, err := session.RegisterAgentDir(ctx, "./team/shared-agents"); err != nil {
		log.Fatal(err)
	}
	tools, err := session.ToolNames(ctx)
	if err != nil {
		log.Fatal(err)
	}
	skills, err := session.SkillNames(ctx)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println("工具：", tools)
	fmt.Println("技能：", skills)

	result, err := session.Run(ctx, "使用项目约定技能搭建一个新模块。")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(result.Text)
}

技能注册表行为

A3S Code 不再内置默认技能。默认有效技能注册表为空。 builtinSkills: true / builtin_skills = True 会被接受以保持兼容，但当前不会添加任何默认 skill。请通过 skillDirs / skill_dirs、inline skills 或显式 SkillRegistry 加载需要的技能。

日常项目里，把可复用行为放进 .a3s/skills 或配置的 skill 目录。

从 agentDirs 加载的自定义子智能体可以在 session.parallel(...) 和 session.pipeline(...) 中按名称引用，与内置注册表中的智能体（explore、plan、general、verification、review）一起使用。

可运行版本位于 sdk/node/examples/skills/test_custom_skills_agents.ts。

#技能与自定义智能体

#技能注册表行为

技能与自定义智能体

技能注册表行为