Task Authoring API

这些 API 是任务作者日常使用的入口，用于声明 task、workspace guardrail 和 Conductor TaskDef。

task(*, name, owner_email[, description, ...])	Declare the single Perago task exported by a Python module.
TaskDefinition(name, owner_email, fn, ...[, ...])	Validated contract extracted from a single Perago task module.
load_module_task(module_target)	Import a module target and return its single Perago task definition.
WorkspaceSpec(*[, prefix, pre, post])	Workspace declaration for a workspace task.
require_file(path)	Require one workspace-relative file to exist.
require_dir(path)	Require one workspace-relative directory to exist.
require_glob(pattern, *[, min_count, max_count])	Require a bounded number of workspace files matching a glob pattern.
forbid_glob(pattern)	Reject workspace files matching a glob pattern.
check_guardrails(root, guardrails, phase)	Evaluate workspace guardrails against a local attempt workspace.
build_taskdef(task)	Build the Conductor TaskDef dictionary for one Perago task.
write_taskdef(task, output)	Write a generated Conductor TaskDef to a JSON file.