agent_kit — 智能体工程学模板与同步工具

单一源头：把 event_bus 项目中沉淀的「智能体工程学」设计（AGENT.md + .agents/ 体系） 抽成可参数化模板，一条命令安装 / 更新到任意项目。

背景

多项目各自维护一份 .agents/ 会逐渐漂移（如 psyche 的副本已落后于 event_bus）。 本仓是这套设计的唯一源头：模板在此演进，通过 agent-kit 分发到各项目。

体系构成

安装到目标项目后产生：

项目根/
├── AGENT.md                      # 引导入口（目录树 + 工作流）
└── .agents/
    ├── agent_kit.toml            # 项目配置（名称 / 工具链 / 启用技能）
    ├── FOR_AGENT.md              # 行为准则与编码规范
    ├── SKILLS/                   # 任务技能
    │   ├── modify-core-api.md
    │   ├── pre-commit-check.md
    │   ├── write-tests.md
    │   ├── write-docs.md
    │   ├── write-skill.md
    │   ├── init-project.md
    │   └── setup-cicd.md
    ├── MEMORY/                   # 跨会话记忆（memorys/ 不入库）
    └── TEMP_FILES/               # 会话临时文件（tmps/ 不入库）

快速开始

用 uv 直接运行（无需克隆本仓；PyPI 包名 infinity-agent-kit，命令行名 agent-kit）：

# 安装到目标项目
uvx --from infinity-agent-kit agent-kit install --target /path/to/project

# 更新（模板演进后同步到项目；memorys/ 与 tmps/ 永不触碰）
uvx --from infinity-agent-kit agent-kit update --target /path/to/project
uvx --from infinity-agent-kit agent-kit update --target /path/to/project --check   # 仅检查漂移（退出码 1 = 有漂移）

# 查看技能目录
uvx --from infinity-agent-kit agent-kit list

长期使用建议持久安装，之后直接调用 agent-kit：

uv tool install infinity-agent-kit
agent-kit install --target /path/to/project

配置

安装时自动探测（pyproject.toml 的 name / description / module-name、src 布局包名）， 结果写入目标项目 .agents/agent_kit.toml，可手工微调后运行 update 生效：

启用 publish 技能：先安装，再编辑配置补上 repo_url / pypi_name 并把 "publish" 加入 skills.enabled，最后运行 agent-kit update。

模板占位符

模板存于 src/agent_kit/template/，支持以下占位符（{{TOKEN}} 之外的文字原样保留）：

设计原则

• 单一源头：静态规则只能通过模板演化 + update 分发；项目内直接修改会被覆盖
• 运行时数据永不被 update 触碰：memorys/ 与 tmps/ 只在安装时创建
• 前端无关：不引入 YAML 头、特定工具名等任一端专属格式（见 write-skill 技能）
• 可校验：update --check 可接入各项目 CI，发现规则漂移

开发

uv sync --extra dev
uv run agent-kit list                  # 从源码运行 CLI
uv run pre-commit install              # 可选：每次提交自动运行质量门
uv run pre-commit run --all-files      # 全量本地质量门

质量门由 .pre-commit-config.yaml 定义（ruff / pyright / interrogate / 覆盖率）； 其中 agent-kit-check 钩子校验受管文件（AGENT.md、.agents/）必须与模板渲染 结果一致——直接修改受管文件或改动模板后忘记 update 都会被阻止提交。

CI（.github/workflows/test.yml）在三个平台 × Python 3.12/3.13/3.14 上运行相同 质量门；推送 v* 标签触发 .github/workflows/publish.yml 构建并发布到 PyPI （Trusted Publisher，需先在 PyPI 注册受信发布者）。

License

MIT

Part of InfinitySystem