72 lines
2.1 KiB
Org Mode
72 lines
2.1 KiB
Org Mode
#+TITLE: SKILL: Delegation Manager (Universal Literate Note)
|
|
#+ID: skill-delegation
|
|
#+STARTUP: content
|
|
#+FILETAGS: :delegation:multi-agent:psf:
|
|
|
|
* Overview
|
|
The *Delegation Manager* orchestrates the dispatch of tasks to sub-agents or specialized skills.
|
|
|
|
* Phase A: Demand (PRD)
|
|
:PROPERTIES:
|
|
:STATUS: FROZEN
|
|
:END:
|
|
|
|
** 1. Purpose
|
|
Define the protocol for delegating work between agents.
|
|
|
|
** 2. User Needs
|
|
- *Trigger:* Detect when a task requires delegation.
|
|
- *Actuate:* Execute the delegation to a target skill or agent.
|
|
|
|
|
|
* Phase B: Blueprint (PROTOCOL)
|
|
:PROPERTIES:
|
|
:STATUS: SIGNED
|
|
:END:
|
|
|
|
|
|
* Phase B: Blueprint (PROTOCOL)
|
|
:PROPERTIES:
|
|
:STATUS: DRAFT
|
|
:END:
|
|
|
|
** 1. Architectural Intent
|
|
The Delegation Manager will utilize a message-passing architecture. Tasks are packaged into messages and routed based on content. A central *resolution* function determines the appropriate target agent or skill for each task. Error handling and fallback mechanisms are crucial for robustness. The core principle is *explicit delegation contracts* to ensure compatibility and predictability.
|
|
|
|
** 2. Semantic Interfaces (Lisp Signatures)
|
|
|
|
*** Task Delegation
|
|
|
|
#+BEGIN_SRC lisp
|
|
;; Sends a task to a target. Returns a promise (future) that will eventually resolve
|
|
;; to the task result. The :delegation-id is internally managed to track the delegation lifecycle.
|
|
(defun delegate-task (task :priority :context)
|
|
:returns (promise task-result))
|
|
#+END_SRC
|
|
|
|
*** Skill Resolution
|
|
|
|
#+BEGIN_SRC lisp
|
|
;; Determines the target agent/skill for a given task.
|
|
;; It receives the task details and any relevant context. Returns the ID of the
|
|
;; targeted agent/skill. Can return `:error` if no suitable delegation is found.
|
|
(defun resolve-skill (task :context)
|
|
:returns (skill-id or :error))
|
|
#+END_SRC
|
|
|
|
*** Error Handling
|
|
|
|
#+BEGIN_SRC lisp
|
|
;; Reports a delegation failure. This allows for fallback strategies.
|
|
(defun report-delegation-failure (delegation-id :error-message)
|
|
:returns nil)
|
|
#+END_SRC
|
|
|
|
*** Task Result Handling
|
|
|
|
#+BEGIN_SRC lisp
|
|
;; Informs the Delegation Manager that a task has been completed successfully.
|
|
(defun report-task-completion (delegation-id :result)
|
|
:returns nil)
|
|
#+END_SRC
|
|
|