Agent Skills › poteto/noodle › noodle

noodle

GitHub

Noodle CLI 操作助手,涵盖命令解释、配置管理及技能编写。支持调度代理、工作区管理及自动化任务编排,用于运行和配置 Noodle 系统。

.agents/skills/noodle/SKILL.md poteto/noodle

触发场景

运行 noodle 命令 编辑 .noodle.toml 配置 编写或更新技能调度字段 询问如何运行 noodle

安装

npx skills add poteto/noodle --skill noodle -g -y
更多选项

非标准路径

npx skills add https://github.com/poteto/noodle/tree/main/.agents/skills/noodle -g -y

不安装直接使用

npx skills use poteto/noodle@noodle

指定 Agent (Claude Code)

npx skills add poteto/noodle --skill noodle -a claude-code -g -y

安装 repo 全部 skill

npx skills add poteto/noodle --all -g -y

预览 repo 内 skill

npx skills add poteto/noodle --list

SKILL.md

Frontmatter
{
    "name": "noodle",
    "description": "Operate the Noodle CLI — explain commands, find flags, create\/edit .noodle.toml config. Also covers writing skills for Noodle: the orders pipeline, task-type schedule fields, stage composition, and the orders-next.json schema. Use when running noodle commands, editing .noodle.toml, writing or updating a skill's schedule field, authoring new task-type skills, or asking \"how to run noodle\", \"noodle help\", \"configure noodle\"."
}

Noodle

Skills that run themselves. Write skills with a schedule: field describing when they should run. Noodle's scheduler agent reads those descriptions, writes orders, and the loop spawns agents in isolated worktrees to do the work.

How the Loop Works

  1. Brief — Noodle gathers project state into .noodle/mise.json (backlog, active agents, history, capacity, registered skills)
  2. Schedule — the scheduler agent reads mise, writes .noodle/orders-next.json
  3. Dispatch — Noodle promotes orders and spawns agent sessions
  4. Execute — each agent runs in its own worktree with the assigned skill
  5. Merge — completed work merges back to main

Skills

A skill is a directory with a SKILL.md. The body is the agent's instructions. The frontmatter is metadata.

General skills (no schedule:) are invoked directly by agents. Examples: commit, debugging.

Scheduled skills (with schedule:) run autonomously. The scheduler reads the schedule: value as prose and uses judgment to decide when conditions are met.

---
name: quality
description: Post-cook quality gate.
schedule: "Follow-up stage after execute. Cross-provider review preferred."
---

Skills live in .agents/skills/ by default. Paths in skills.paths are searched in order; first match wins.

For the full guide on writing skills, orders, and schedule fields, see references/skill-authoring.md.

Configuration

Noodle reads .noodle.toml at project root. Scaffolded on first noodle start. Most projects only need:

mode = "supervised"  # auto | supervised | manual

[routing.defaults]
provider = "claude"
model = "claude-opus-4-6"

[skills]
paths = [".agents/skills"]

Full config reference: references/configuration.md

CLI

All commands accept --project-dir (default: current directory, env: NOODLE_PROJECT_DIR).

Core

Command Description
noodle start Start the noodle loop
noodle start --once Run one scheduling cycle and exit
noodle status Show runtime status (active agents, queue depth, loop state)
noodle reset Clear all runtime state (refuses if loop is running)

Skills & Schemas

Command Description
noodle skills List resolved skills
noodle skills list List all resolved skills
noodle schema <target> Print schema docs for a target
noodle schema list List available schema targets (mise, orders, status)

Worktrees

Command Description
noodle worktree create <name> Create a new linked worktree
noodle worktree create <name> --from <ref> Create from a specific branch or commit
noodle worktree exec <name> <command...> Run a command inside a worktree (CWD-safe)
noodle worktree merge <name> Merge a worktree branch into integration branch
noodle worktree merge <name> --into <branch> Merge into a specific target branch
noodle worktree list List all worktrees with merge status
noodle worktree prune Remove merged and patch-equivalent worktrees
noodle worktree cleanup <name> Remove a worktree without merging
noodle worktree cleanup <name> --force Remove even with unmerged commits
noodle worktree hook Run worktree session hook (used internally)

Events

Command Description
noodle event emit <type> Emit an external event into the loop
noodle event emit <type> --payload <json> Emit with a JSON payload
noodle event emit <type> --session <id> Emit to a specific session's event log

Full CLI reference: https://poteto.github.io/noodle/reference/cli

Troubleshooting

  1. "fatal config diagnostics prevent start" — Check .noodle.toml against noodle schema.
  2. Missing adapter scripts — Create scripts or update paths in config.
  3. Stale worktrees — noodle worktree list, then noodle worktree prune.

References

版本历史

  • 82d2921 当前 2026-11-19 21:08

同 Skill 集合

.agents/skills/adversarial-review/SKILL.md
.agents/skills/ast-grep/SKILL.md
.agents/skills/brain/SKILL.md
.agents/skills/codex/SKILL.md
.agents/skills/commit/SKILL.md
.agents/skills/debugging/SKILL.md
.agents/skills/execute/SKILL.md
.agents/skills/find-skills/SKILL.md
.agents/skills/frontend-design/SKILL.md
.agents/skills/go-best-practices/SKILL.md
.agents/skills/interaction-design/SKILL.md
.agents/skills/make-interfaces-feel-better/SKILL.md
.agents/skills/meditate/SKILL.md
.agents/skills/oops/SKILL.md
.agents/skills/plan/SKILL.md
.agents/skills/quality/SKILL.md
.agents/skills/react-best-practices/SKILL.md
.agents/skills/refine/SKILL.md
.agents/skills/reflect/SKILL.md
.agents/skills/review/SKILL.md
.agents/skills/ruminate/SKILL.md
.agents/skills/schedule/SKILL.md
.agents/skills/skill-creator/SKILL.md
.agents/skills/testing/SKILL.md
.agents/skills/todo/SKILL.md
.agents/skills/unslop/SKILL.md
.agents/skills/worktree/SKILL.md
examples/minimal/.agents/skills/execute/SKILL.md
examples/minimal/.agents/skills/schedule/SKILL.md
examples/multi-skill/.agents/skills/execute/SKILL.md
examples/multi-skill/.agents/skills/schedule/SKILL.md
skills/skill-creator/SKILL.md
.agents/skills/ts-best-practices/SKILL.md
examples/multi-skill/.agents/skills/deploy/SKILL.md
examples/multi-skill/.agents/skills/test/SKILL.md

元信息

文件数
0
版本
82d2921
Hash
1f8570c0
收录时间
2026-11-19 21:08

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-19 22:47
浙ICP备14020137号-1