KtKID

Kongming Agent — Development skill for Claude Code

Development community

A general agent that proactively observes the workspace, ships built-in workflows, and coordinates multiple agents.

How to install Kongming Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open KtKID/kongming-agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Kongming Agent does

A general agent that proactively observes the workspace, ships built-in workflows, and coordinates multiple agents.

Alternatives in Development

Agent.System.Main.Tips — General operation manual 19k ★
Releasing — This project ships as a Claude Code plugin 10.9k ★
Zeroshot — Runs coding agents as a graph: one agent implements, independent agents review, failures go to repair, and not 1.9k ★

README

kongming-agent

简体中文 · English

async-first 的通用 agent 内核——单一 run loop 之上叠加 LLM 自选的多 agent workflow 编排，自带主动观察者（司天）、自我进化证据链和三层安全链。

不只是 coding agent——内核与场景无关，工具层可接 file / shell / memory / skill / MCP server；通过 sidecar 接入桌面/移动宿主，computer use 开发中
LLM 自己选编排策略——对话中调用 run_agent_workflow，在 parallel / map_reduce / deep_research / roundtable_review / task_flow 里挑一个，把目标拆给独立 session 的子 agent 协作
司天：agent 会主动观察——不等你提问，后台扫描工作区，物化 work_item 和下一步建议
自我进化——每轮对话结束后台复盘证据窗口，把 review 与进化养料（memory / workflow / error 三类）写回长期记忆
三层安全链 + thread 本子——DangerGuard → 审批模式 → 按 thread 独立 allow/deny，cron task 还能声明自己的审批模式
模型无关，本地零成本起步——OpenAI-compat / Anthropic 都接，本地 preset 自动跳过远端 key 校验
工程纪律可执行——import-linter 强制架构边界、协议单一真源、@override 强制、commit+push 双层 hook

Quick Start

1. 安装依赖

cd /path/to/kongming-agent
uv sync --all-extras

或用统一入口脚本：

./start.sh install        # macOS / Linux

Windows 暂无等价入口脚本，请用 `uv sync --all-extras`。

2. 配模型 key

模型通过 **preset catalog**（`config/model-providers.yaml`）选择，不再用裸 base_url + 模型名拼装。**默认 preset 是 `local-gemma-4-e4b-it`（本地）**——开箱即用需要先起一个监听 `127.0.0.1:62000` 的 OpenAI 兼容服务（LM Studio / Ollama / vLLM 均可），本地 preset 自动跳过远端 key 校验。想用远端模型时切到 `minimax-m3` / `deepseek` / `bigmodel-glm5-1m` 等 preset 并配上对应的 provider key。