AGENT SKILL

agora-awareness

Understand the Agora multi-agent collaboration framework — how teams, projects, kanban, discussions, and heartbeat work together. Every worker should know this. If you want to SET UP an Agora team, read the agora-setup skill instead.

License 许可
MIT
最近更新
2026-10-08
Stars
★ 11
Forks
3

01 前言 Front Matter

name
agora-awareness
category
collaboration
description
Understand the Agora multi-agent collaboration framework — how teams, projects, kanban, discussions, and heartbeat work together. Every worker should know this. If you want to SET UP an Agora team, read the agora-setup skill instead.

03 SKILL.md 正文

Agora — Multi-Agent Collaboration Framework

You are part of an Agora team — a multi-agent system where specialized AI agents collaborate on software projects. This skill helps you understand how Agora works so you can participate effectively.

Want to create a team? Read the agora-setup skill for the full setup guide (create workers, form teams, start projects).

Core Concepts

Team

A group of specialized workers (agents) with distinct roles. Each worker has:

  • SOUL.md — your identity, philosophy, and working style. You can evolve this over time.
  • config.yaml — your Hermes profile configuration.
  • skills/ — your personal skill library. You can create new skills here.
  • sessions/ — isolated conversation history per project.

Roles

Common roles include: architect, developer, reviewer, tester, devops, researcher, writer, leader. Your role defines your expertise and perspective. Your SOUL.md embodies this.

Project

A workdir-based development effort. Each project has:

  • Heartbeat — a cron-driven cycle that wakes the leader to plan and dispatch work.
  • Kanban board — task tracking (triage → todo → running → done).
  • Discussions — structured deliberation for decisions.

Heartbeat Cycle

  1. Leader wakes via cron heartbeat.
  2. Leader checks project status (completed tasks, blocked tasks, next steps).
  3. Leader creates/updates kanban tasks and dispatches them to workers.
  4. Workers execute tasks (each spawn = one hermes chat session).
  5. Leader evaluates results and plans next heartbeat.

Self-Driving Philosophy (for Leaders)

  • Never stop voluntarily. When a phase completes, evaluate: bugs, tech debt, test coverage, documentation, performance, security, UX.
  • Output ALL_GOOD to signal "continue working" (found more to do).
  • Only output PROJECT_COMPLETE when genuinely nothing remains.
  • Two consecutive PROJECT_COMPLETE signals are required to stop the project.

How You Should Work

When Dispatched a Task

  1. Read the task description from your kanban assignment.
  2. Check the project workdir for context (AGENTS.md, README, code).
  3. Execute the task — write code, review, test, etc.
  4. Use kanban tools to update task status (mark running, then done/blocked).
  5. If blocked, explain why in the task and set status to blocked.

Self-Growth (2 Channels)

Workers evolve through two channels (the old memory tool was removed in v1.8.6):

  1. Skills — Use skill_manage(action='create') to save reusable procedures. Skills are stored in your personal ~/.hermes/profiles/<your-name>/skills/ directory. You can also read shared global skills from ~/.hermes/skills/. Save a skill when you discover a workflow worth reusing.
  2. SOUL.md — Use patch to edit your identity file when you want to permanently adjust your working style, priorities, or protocols. This is your constitution — evolve it deliberately, not impulsively. You may only patch your own SOUL.md — never project files.

MEMORY.md is written by the discussion engine and hooks — you do not write to it directly.

Participating in Discussions

  • Discussions follow a structured flow: open → speak rounds → vote → close.
  • The chair (usually the leader) facilitates.
  • Share your role-specific perspective. Be concise but thorough.
  • Vote on the proposed resolution.

Kanban Quick Reference

  • agora_create_task tool — create task (Leader only; avoids CLI false warning)
  • kanban update <id> --status running — start working
  • kanban update <id> --status done — complete task
  • kanban update <id> --status blocked --note "..." — report blocker
  • kanban list — see all tasks
  • agora_close_task(task_id, action="submit_review") — submit for code review (v1.8.6+; transitions to review status, auto-assigns to reviewer, dispatcher auto-spawns reviewer)
  • agora_close_task(task_id, action="complete") — mark task done (leader/worker)
  • agora_close_task(task_id, action="cancel") — archive task

Key Files in Your Profile

  • ~/.hermes/profiles/<your-name>/SOUL.md — your identity
  • ~/.hermes/profiles/<your-name>/config.yaml — your config
  • ~/.hermes/profiles/<your-name>/skills/ — your skills
  • ~/.hermes/profiles/<your-name>/agora/ — agora metadata (projects, registry)

Tips

  • You are part of a team. Your work affects others. Communicate via task notes.
  • Don't wait for instructions — if you see something that needs doing, do it.
  • Quality over speed. Tests, docs, and clean code matter.
  • Your SOUL.md is yours to shape. Make it reflect who you are as an agent.

04 同仓库更多 Skills