ac-config-manager

用途

AC Config Manager 是 Auto-Claude 复制技能集中的集中式配置管理工具，专为自主编码（autonomous coding）场景设计。它统一管理自主编码所需的全部配置，包括环境变量、提供方设置（LLM、嵌入、记忆）、构建配置、安全限制以及路径管理。

主要能力

加载配置：通过 ConfigManager(project_dir) 实例化后调用 config.load() 加载设置，合并顺序为：默认值 → 环境变量 → 配置文件 → 覆盖项。
创建配置：调用 config.create_default_config() 生成 .claude/autonomous-config.json 默认配置文件。
更新配置：通过 config.update({...}) 更新指定字段，如 max_iterations、max_cost_usd、verbose。
校验配置：调用 config.validate() 返回错误列表。
获取提供方设置：config.get_memory_config() 返回 Graphiti 配置，config.get_build_config() 返回构建设置。
路径管理：config.get_paths() 返回 specs_dir、worktrees_dir、memory_dir、checkpoints_dir 等路径。

使用方式

加载配置

from scripts.config_manager import ConfigManager
config = ConfigManager(project_dir)
settings = config.load()
model = settings.model  # claude-opus-4-5-20251101
max_iterations = settings.max_iterations  # 50

创建配置

config.create_default_config()
# Creates .claude/autonomous-config.json with defaults

更新配置

config.update({
    "max_iterations": 30,
    "max_cost_usd": 15.00,
    "verbose": True
})

校验配置

errors = config.validate()
if errors:
    for error in errors:
        print(f"Config error: {error}")

获取提供方设置

memory_config = config.get_memory_config()
build_config = config.get_build_config()

路径管理

paths = config.get_paths()
# Returns:
#   specs_dir: .auto-claude/specs/
#   worktrees_dir: .worktrees/auto-claude/
#   memory_dir: .claude/memory/
#   checkpoints_dir: .claude/checkpoints/

配置结构

配置文件位于 .claude/autonomous-config.json，包含以下字段：

{
  "enabled": true,
  "objective": "Build feature X",
  "success_criteria": [
    "All tests pass",
    "Code coverage > 80%"
  ],
  "max_iterations": 50,
  "max_cost_usd": 20.00,
  "max_consecutive_failures": 3,
  "max_runtime_minutes": 480,
  "analyzer_model": "claude-sonnet-4-20250514",
  "verbose": false,
  "notify_on_complete": true
}

环境变量

变量	必需	默认值	说明
ANTHROPIC_API_KEY	是	-	Claude 的 API 密钥
AUTO_BUILD_MODEL	否	claude-opus-4-5-20251101	构建使用的模型
DEFAULT_BRANCH	否	auto-detect	基础分支
GRAPHITI_ENABLED	否	true	启用记忆
GRAPHITI_LLM_PROVIDER	否	openai	记忆使用的 LLM
GRAPHITI_EMBEDDER_PROVIDER	否	openai	嵌入提供方
DEBUG	否	false	调试日志
DEBUG_LEVEL	否	1	详细程度（1-3）

构建配置

@dataclass
class BuildConfig:
    model: str = "claude-opus-4-5-20251101"
    max_thinking_tokens: dict = field(default_factory=lambda: {
        'planner': 5000,
        'coder': None,
        'qa_reviewer': 10000,
        'qa_fixer': None
    })
    max_iterations: int = 50
    max_parallel_agents: int = 4
    skip_qa: bool = False
    timeout_ms: int = 600000

默认值

设置	默认值	说明
enabled	false	自主模式
max_iterations	50	最大循环迭代次数
max_cost_usd	20.00	预算限制
max_consecutive_failures	3	升级前最大连续失败次数
max_runtime_minutes	480	8 小时限制
context_threshold	0.85	触发交接
auto_checkpoint	true	创建检查点

集成点

ac-state-tracker：加载状态配置
ac-session-manager：获取会话设置
ac-memory-manager：获取记忆提供方配置
ac-cost-optimizer：获取预算限制
ac-opus-analyzer：获取分析器模型

参考与脚本

references/CONFIG-SCHEMA.md - 完整 schema 文档
references/ENVIRONMENT.md - 环境变量指南
scripts/config_manager.py - 核心 ConfigManager 类
scripts/config_schema.py - 配置 schema
scripts/path_manager.py - 路径工具

适用场景

适用于使用 Auto-Claude 复制技能集进行自主编码的开发流程，需要在多个技能之间共享配置、管理环境变量、控制预算与安全限制、以及统一路径管理的场景。

限制

资料未提供关于平台兼容性、安装方式、收费模式或具体性能表现的说明。