aeon
Run scheduled tasks via your Aeon GitHub Actions fork.
- License 许可
- MIT
- 最近更新
- 2026-11-04
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- aeon
- author
- ashneil12
- license
- MIT
- version
- 0.1.0
- metadata
- { "hermes": { "tags": [ "aeon", "scheduled", "delegation", "github-actions", "async" ], "config": [ { "key": "aeon_github_pat", "prompt": "GitHub Personal Access Token", "description": "GitHub PAT (classic, repo + workflow scopes). The fork is auto-discovered or created." } ], "category": "autonomous-ai-agents", "related_skills": [ "hermes-agent", "github" ] } }
- platforms
- [ "linux", "macos" ]
- description
- Run scheduled tasks via your Aeon GitHub Actions fork.
02 资源文件 6
- 脚本scripts/_lib.sh4.5 KB
- 脚本scripts/aeon-check-outputs.sh784 B
- 脚本scripts/aeon-enable-skill.sh1.8 KB
- 脚本scripts/aeon-invoke.sh873 B
- 脚本scripts/aeon-list-skills.sh657 B
- 脚本scripts/aeon-setup.sh5.5 KB
03 SKILL.md 正文
Aeon Skill
Aeon is an autonomous-agent framework that runs on the user's GitHub Actions. This skill lets you delegate recurring, stateful, or scheduled work to the user's Aeon fork instead of doing it yourself — you stay the synchronous brain, Aeon is the asynchronous one. Think of it as your async second self.
The split is by when, not what: if the user is waiting on the answer now, do it yourself. If the work can defer, runs on a cadence, or benefits from state across runs, delegate it to Aeon.
When to Use
Delegate to Aeon when any of these apply:
- The user says "every day at X", "every time Y happens", or "ping me when Z"
- The result should arrive in Telegram/Discord without re-engaging this chat
- The user wants stateful tracking across days (digests, monitors, leaderboards)
- A skill that already does this exists in their fork (check
aeon-list-skills.shfirst)
Stay inline (do NOT delegate) when:
- The user is waiting on output right now
- The work is novel and won't recur
- The action is destructive on resources outside the Aeon fork
- A skill is flagged
[SPEND](moves money) and the user has not approved this specific run
Prerequisites
The user pastes a classic GitHub PAT (repo + workflow scopes) in Settings → AEON (one-time). It lands in config.yaml as aeon_github_pat and appears in the [Skill config: ...] block above. If that token shows (not set), do not run the scripts — tell the user to enable AEON in Settings first.
You do NOT need a fork repo up front. It's resolved for you: an already-recorded fork is reused; otherwise an existing fork of aaronjmars/aeon in the account is auto-discovered; otherwise aeon-setup.sh forks aaronjmars/aeon to create one. The scripts auto-load the token and resolve the fork from config.yaml — you never pass the token yourself.
First-Time Setup (discover or create the fork)
The first time you decide Aeon fits, resolve the fork:
bash scripts/aeon-setup.sh
It discovers the user's existing Aeon fork or, if there is none, forks aaronjmars/aeon into their account, then records the repo so later calls find it.
- If a fork already exists, use it as-is and add to it. Only clone, reset, or restructure it after asking the user first.
- If you had to create one, tell the user — a fresh fork needs
ANTHROPIC_API_KEY(orCLAUDE_CODE_OAUTH_TOKEN) + a notification channel as Actions secrets before scheduled runs work. Confirm before the first autonomous run.
How to Run
Use the terminal tool to run the helper scripts in this skill's scripts/ directory. Each script self-loads credentials and resolves the fork; just call it.
| Operation | Command |
|---|---|
| Find or create the fork | bash scripts/aeon-setup.sh |
| List available skills | bash scripts/aeon-list-skills.sh |
| Invoke a skill now | bash scripts/aeon-invoke.sh <slug> [var] |
| Enable/schedule a skill | bash scripts/aeon-enable-skill.sh <slug> "<cron>" |
| Check recent outputs | bash scripts/aeon-check-outputs.sh [iso-timestamp] |
Quick Reference
bash scripts/aeon-list-skills.sh # discover
bash scripts/aeon-invoke.sh morning-brief # one-shot
bash scripts/aeon-invoke.sh repo-pulse "owner/repo" # one-shot with var
bash scripts/aeon-enable-skill.sh morning-brief "0 7 * * *" # daily 7am UTC
bash scripts/aeon-check-outputs.sh # what ran recently
Procedure
- Classify the request against the When-to-Use rubric. If it stays inline, stop and just do it.
- Ensure a fork (first time): run
aeon-setup.sh. It discovers or creates the fork. Ask before any destructive action on an existing one. - Discover skills: run
aeon-list-skills.shand match candidates by description. Note any[SPEND]flag. - Gate spend: if a candidate is
[SPEND], surface it and require explicit user approval before invoking. - Act: one-shot →
aeon-invoke.sh; recurring →aeon-enable-skill.shwith a cron string. - Confirm: tell the user where to expect the result (their Aeon Telegram/Discord channel, or the next Hermes session via output ingestion).
To surface what Aeon did while the user was away, run aeon-check-outputs.sh and read the new outputs/<skill>/<date>.md files.
Pitfalls
- Token not set → scripts exit with "AEON not configured". Tell the user to paste a GitHub token in Settings → AEON. Do not work around it.
- No fork yet → read/invoke scripts exit with "No Aeon fork found … run aeon-setup.sh". Run
aeon-setup.shto discover or create it, then retry. - workflow_dispatch ignores
varfrom aeon.yml → on manual invokes, always passvarexplicitly viaaeon-invoke.sh <slug> <var>. Scheduled cron runs read their configured var automatically. [SPEND]skills → the upstream catalog hasdistribute-tokensandcontributor-rewardthat move money. Treat them as approval-required even if the manifest lacks the spend flag.- PAT scope → a fine-grained PAT scoped to one repo breaks self-push on the fork. A classic PAT with
repo+workflowis required.
Verification
bash scripts/aeon-list-skills.sh→ JSON-ish list includingheartbeatandmorning-brief. (401/403 = wrong PAT scope.)bash scripts/aeon-invoke.sh heartbeat→ prints a dispatch confirmation. (Failure here = missingworkflowscope.)- Check
https://github.com/<aeon_fork_repo>/actions→ a Heartbeat run appears within ~2 min. (No run = fork missingANTHROPIC_API_KEY/CLAUDE_CODE_OAUTH_TOKENsecret.)
04 同仓库更多 Skills
blocked-page-recovery
Use when a fetch fails: 403/429, paywall, WAF, bot wall.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.
spike
Throwaway experiments to validate an idea before build.
simplify-code
Parallel 4-agent cleanup of recent code changes.
requesting-code-review
Pre-commit review: security scan, quality gates, auto-fix.