SuperAPI AI 工具集

ac-session-manager

智能体与模型

查看项目

更新于 10-15 09:59

技能介绍

用途

AC Session Manager 用于自主编程(autonomous coding)的会话生命周期管理。适用场景包括:启动会话、恢复此前工作、检测会话类型(初始化 INIT 与继续 CONTINUE),以及在不同会话之间管理状态与交接。

主要能力

  • 会话类型检测:区分 INIT、CONTINUE_FROM_HANDOFF、CONTINUE_IMPLEMENTATION 与 COMPLETE 四种类型。
  • 会话创建与配置:初始化 SDK 客户端、配置工具与权限、设置工作目录。
  • 运行会话:执行初始器或编码提示,处理工具调用并捕获结果。
  • 自动续接:会话结束后可自动开始下一会话,支持设置延迟时间。
  • 优雅关闭:保存状态并创建交接包,供下一会话恢复。
  • 状态持久化:将会话状态写入 .claude-session-state.json,记录会话 ID、类型、状态、迭代次数、起始时间、本会话处理的功能与上下文使用率。

使用方式

检测会话类型:

from scripts.session_manager import SessionManager

manager = SessionManager(project_dir)
session_type = await manager.detect_type()

if session_type == "INIT":
    await manager.run_initializer()
elif session_type == "CONTINUE":
    await manager.run_continuation()
elif session_type == "COMPLETE":
    print("All features complete!")

运行会话:

async with SessionManager(project_dir) as session:
    result = await session.run(prompt)
    print(f"Status: {result.status}")

创建会话、运行初始器、运行继续、配置自动续接与优雅关闭等操作,均有对应 API 示例(如 SessionManager.create、session.run_initializer、session.run_continuation、session.configure_auto_continue、session.shutdown)。

会话类型与检测逻辑

  • INIT:无 feature_list.json 时触发,运行初始器代理。
  • CONTINUE_FROM_HANDOFF:存在 handoffs/current.json 时触发,从交接恢复。
  • CONTINUE_IMPLEMENTATION:功能未完成时触发,继续编码。
  • COMPLETE:所有功能通过时触发,生成报告并退出。

适用场景

适合需要跨多个会话持续推进的自主编码任务,例如初始化项目功能清单、按 TDD 逐个实现功能、在上下文接近上限时交接并恢复。相关参考资料包括 SESSION-LIFECYCLE.md、PROMPTS.md、MULTI-SESSION.md,脚本包括 session_manager.py、session_detector.py、auto_continue.py、prompts.py。

限制

资料未提供收费、价格、平台覆盖范围或实际运行效果等说明,相关事实暂未提供。