菜单
Foundational principles for working in the machine: delegation to specialist agents, a language-agnostic quality gate, progressive disclosure, and modular skill structure. Use when creating agents/skills or deciding how to route work.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
File a machine self-diagnostic report as a tagged GitHub issue. When a tool, daemon, hook, skill, or agent hangs, errors, returns garbage, or behaves wrong, open a `machine-report`-labeled issue on the machine plugin repo so every plugin user's reports funnel to the maintainer. Requires `gh` logged in. Write-side only — it logs, it does not fix. Trigger: "/report", "report a problem", "this tool is broken", "file a machine report", "log this hang/error/hiccup".
Consume the machine self-diagnostic backlog. Lists the open `machine-report` GitHub issues on the machine repo, ranks them by severity then age, fixes the single highest-priority one at its root cause, verifies green, then closes that issue. The act side of /report (which only writes). Machine-repo-only skill — not shipped to other installs. Trigger: "/resolve", "resolve a report", "triage the reports", "fix the top report", "work the reports backlog".
Second-AI review via the Codex CLI at the drill's single review point — the consolidated review of the finished diff, alongside the persona panel, before a landing is proposed. Advisory only: it returns notes and concerns for the driver and user to weigh, it never gates, blocks, merges, or edits. Skips cleanly when codex is not installed. Trigger via "/codex-review", "codex review", "second opinion from codex", or invoked by the drill skill.
The drill — the orchestrator's default driver mode. Runs grill-first: the drill and the user refine a request one question at a time until the user calls it a valid plan. From there the job runs autonomously — a plan subagent writes a markdown brief, a miner implements it on a git-fs branch inside the orchestrator's worktree, and the gate iterates until the build is green — with one consolidated advisory review (personas + codex) at the end. The drill surfaces only to land the work into main, plus on any blocker it cannot resolve. The live roster lives in the hub (claims + board), not on disk. Trigger via "/drill", "drill mode", "orchestrator mode", "background this", "spawn an agent for this", "drive this".
Promote crystallized brainstorm findings into board tickets. After a brainstorm (drill grill) settles one or more well-scoped features, this turns each into a card on the current cwd's board so the drill's plan step can iterate per ticket. The bridge between brainstorm and plan — it creates tickets, it does not plan or implement. Trigger: "/promote", "promote these", "promote to tickets", "make tickets", "turn findings into cards".
Run the single ongoing chat that resolves the open plan and implementation questions parallel agents raise. Plan/implement agents post questions to mesh and wait; the questioneer aggregates them into one prioritized queue, presents each to you for a decision, and writes the answer back so the waiting agent proceeds. It routes decisions — it does not plan, implement, or dispatch. Trigger: "/questioneer", "questioneer", "answer the questions", "resolve open questions", "what are the agents blocked on".
| name | foundation-core |
| description | Foundational principles for working in the machine: delegation to specialist agents, a language-agnostic quality gate, progressive disclosure, and modular skill structure. Use when creating agents/skills or deciding how to route work. |
| license | Apache-2.0 |
| compatibility | Designed for Claude Code |
| allowed-tools | Read, Grep, Glob, mcp__plugin_machine_context7__resolve-library-id, mcp__plugin_machine_context7__query-docs |
| user-invocable | false |
| metadata | {"version":"3.0.0","category":"foundation","status":"active","updated":"2026-06-12","tags":"foundation, core, delegation, quality-gate, progressive-disclosure, modular"} |
| progressive_disclosure | {"enabled":true,"level1_tokens":100,"level2_tokens":5000} |
| triggers | {"keywords":["delegation","agent","skill","quality gate","progressive disclosure","modular","routing"],"agents":["manager-spec","manager-ddd","manager-strategy","manager-quality","builder-agent","builder-skill"]} |
The principles that keep work in the machine correct, delegated, and verifiable.
The canonical authority is .claude/agents/default.md (Machine law) plus the
project layer in /.machine/; this skill explains the why behind four recurring
decisions. It never overrides Machine law or project law.
The default agent is an orchestrator, not a do-everything implementer. Route domain work to the specialist that owns it rather than executing it inline — delegation buys an independent context and domain focus.
name: frontmatter, not by path. The dispatch table
lives in default.md; the catalog of who-does-what is there and in
/.machine/project.md.parallel skill).Every non-trivial change must pass the machine's five-dimension quality gate
before it is called done; the five dimensions are defined canonically in the
foundation-quality skill (the single source other skills reference). /gate
runs the concrete check — it detects fmt/lint/test/build, or reads the exact
commands from /.machine/project.md.
Verify by evidence, not by feeling: run the check and quote the output
(the verify skill). In this repo "build" means
configuration integrity — hooks pass node --check, settings.json parses, and
every agent/skill reference resolves.
Deliver knowledge in tiers so context budget is spent on what the task needs.
SKILL.md is the entry point: a quick reference plus an implementation
guide, kept compact. Deep material moves to modules/<topic>.md, reached only
when the task demands it.examples.md holds working samples; references/ holds external links and
API detail. Cross-reference instead of inlining.Keep each skill self-describing and small.
name must match the name: frontmatter, or dispatch loads the
wrong (or no) skill.modules/ rather than
growing one file unboundedly.@file instead of copying.default.md — Machine law and the live dispatch table (authority)./.machine/project.md, /.machine/agent.md — project facts, paths, and project law.foundation-cc — Claude Code authoring detail for skills, agents, hooks,
plugins, and settings.foundation-quality — the quality-gate mechanics in depth./gate — the stack-detecting pre-commit check.name: frontmatter no longer matches its path.