Agent Skills › poteto/noodle › execute

execute

GitHub

提供任务执行的标准化方法论,涵盖范围界定、任务分解、Worktree工作流隔离、验证及提交规范。旨在确保多会话并发下的代码安全与交付质量。

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

触发场景

execute implement build this code this

安装

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

非标准路径

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

不安装直接使用

npx skills use poteto/noodle@execute

指定 Agent (Claude Code)

npx skills add poteto/noodle --skill execute -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": "execute",
    "schedule": "When backlog items with linked plans are ready for implementation",
    "description": "Implementation methodology for executing tasks. Handles scoping, decomposition, worktree workflow, verification, and commit conventions. Triggers: \"execute\", \"implement\", \"build this\", \"code this\"."
}

Execute

Implementation methodology. Loads alongside the domain skill (e.g., "noodle") — this teaches process, the domain skill teaches the codebase. Operate fully autonomously. Never ask the user. Don't stop until the work is fully complete.

Track all work with Tasks (TaskCreate, TaskUpdate, TaskList). One task per decomposed change; mark in_progress when starting, completed when done.

1. Scope

Establish what needs doing:

  • Plan phase: Read the assigned phase from brain/plans/. Read the overview for scope boundaries. Invoke Skill(backlog) for project-specific context. Load domain skills listed in "Applicable skills."
  • Backlog item: Read the todo from brain/todos.md. If a linked plan exists, read it. Otherwise, scope from the description.
  • Ad-hoc request: The user prompt is the scope. Identify affected files and packages before starting.

Output: a clear, bounded description of what changes and what doesn't.

2. Decompose

Break scope into discrete changes. Each change:

  • One function/type + its tests, OR one bug fix
  • Independently compilable
  • One conventional commit

Single-change scopes skip decomposition.

3. Implement

Worktree First — Non-Negotiable

Never edit files on main. Multiple sessions run concurrently; editing main causes merge conflicts and lost work.

If CWD is already inside .worktrees/, use it. Otherwise: noodle worktree create <descriptive-name>

Use absolute paths or noodle worktree exec <name> <cmd>. Never cd into a worktree — if it gets removed while the shell is inside, the session dies permanently.

Commit inside the worktree. When done: noodle worktree merge <name>

Skip only when the user is interactively driving a single-agent session and explicitly chooses main.

Delegation

  • Self-execute: Single change, or tightly coupled changes (shared types, sequential dependencies).
  • Sub-agents: 2+ independent changes touching different files. Front-load context: scope, relevant code, domain skill name.
  • Team execution: 2+ parallelizable phases in a plan. See references/team-execution.md.
  • Codex: Mechanical work not requiring judgment (renames, boilerplate, repetitive edits). Never for architectural decisions.

Sequential is fine when phases are tightly coupled. Before parallelizing, ask: "Does any phase's output become another phase's input?" Phases with shared type-level contracts must be sequential.

4. Verify

Run the full verification suite before committing. See references/verification.md for the complete checklist. Never commit failing code — fix and re-verify on failure.

5. Commit

<type>(<scope>): <description> with optional Refs: #<issue-ID> footer. Types: feat, fix, refactor, test, docs, chore. One commit per logical change.

6. Yield

After all changes are committed and verified, emit stage_yield:

noodle event emit --session $NOODLE_SESSION_ID stage_yield --payload '{"message": "Implemented: <brief summary>"}'

Without this, the stage only completes on clean process exit — interrupted work is lost to the pipeline.

Scope Discipline

  • Only change what's in scope. No defensive code, backwards-compat shims, or speculative features.
  • Out-of-scope discoveries go in the quality review notes — don't change them.
  • Wrong or incomplete plan/requirements: flag it in output, don't silently deviate.

Principles

Read at runtime from brain/principles/:

  • [[prove-it-works]]
  • [[subtract-before-you-add]]
  • [[cost-aware-delegation]]
  • [[guard-the-context-window]]
  • [[boundary-discipline]]
  • [[outcome-oriented-execution]]

版本历史

  • 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/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/noodle/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
1b92ef09
收录时间
2026-11-19 21:08

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