360 Secure SkillHub
360 安全技能中心

Create Agent

通过命令行参数创建或校验 Overstory agent，自动同步 config.yaml、agent-manifest.json、agent-def 定义、网关提示词、task_router、generate_agent_context 等七个集成点，并支持从日志、TROUBLESHOOTING.md 等来源分析后给出新 agent 建议。

RuneweaverStudios
RuneweaverStudios
热度 74.86
最近更新 2026-05-20 03:38:59
分类：开发依赖：代码执行 / 读写文件应用场景：代码生成 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add create-agent
Metadata
name
create-agent
displayName
Create Agent | Overclaw Skill
description
Creates new Overstory agents for Overclaw by updating all seven integration points (config, manifest, agent-def, gateway prompt, task_router, generate_agent_context, and regeneration). Supports manual creation and optional analysis from logs, TROUBLESHOOTING.md, mulch, and project tree.
version
1.0.0

Create Agent

Creates and registers new Overstory agents so Overclaw can recognize and use them. Automates the steps documented in .overstory/CREATING_AGENTS.md.

When to use

  • You want to add a new agent type (e.g. troubleshooter, docs-writer) to Overclaw.
  • You want to ensure all seven integration points are updated consistently.
  • You want to suggest new agents from Overclaw logs, TROUBLESHOOTING.md, mulch, or project structure.

Scripts

create_agent.py

Main CLI for creating or validating agents.

Manual creation:

python3 scripts/create_agent.py \
  --name "troubleshooter" \
  --description "Analyzes logs and troubleshoots issues" \
  --capabilities "troubleshoot,debug,analyze" \
  --model "sonnet" \
  --tools "Read,Glob,Grep,Bash" \
  --can-spawn false \
  --constraints "read-only"

Options: --dry-run (preview only), --no-regenerate (skip gateway context regeneration), --rollback-on-fail (revert changes if validation fails).

Analysis mode (suggestions only):

python3 scripts/create_agent.py \
  --analyze-from-logs \
  --analyze-from-troubleshooting \
  --suggest-only

analyze_agent_needs.py

Helper for analysis mode: parses logs, TROUBLESHOOTING.md, mulch, and project tree to suggest new agent definitions. Can be run standalone or via create_agent.py --analyze-*.

Integration points updated

  1. .overstory/config.yaml — capability entry
  2. .overstory/agent-manifest.json — agent + capabilityIndex
  3. .overstory/agent-defs/<name>.md — agent definition
  4. scripts/overclaw_gateway.py — orchestrator system prompt
  5. skills/nanobot-overstory-bridge/scripts/task_router.py — CAPABILITY_PATTERNS
  6. skills/nanobot-overstory-bridge/scripts/generate_agent_context.py — CAPABILITY_PRIVILEGES
  7. Regeneration of gateway-context.md and skills-manifest.json

References