菜单
Creates or updates .specs/guidelines.md with project-wide stack, conventions, and principles. Use when starting a project or when a fundamental technology decision has changed.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Execute a Trellis task list by dispatching each task to a Claude Code subagent in its own context window. Use when the user says "build with sub-agents", "build with subagents", or when a feature has 5-20 tasks with dependencies between them. Reads `.specs/<feature>/tasks.md` produced by the tasks skill. Each subagent gets focused context (guidelines + plan + task + learnings) and returns results to the orchestrating session. Supports parallel execution of independent tasks via background subagents with worktree isolation.
Execute a Trellis task list using Claude Code's /batch command for bulk, patterned changes across many files. Use when the user says "build with batch" or when a feature involves repetitive changes across dozens or hundreds of files (e.g., migrating from one library to another, applying naming conventions, adding error handling patterns). Reads `.specs/<feature>/tasks.md` produced by the tasks skill. Translates the task list into one or more /batch invocations with worktree-isolated parallel agents.
Use when user wants to Creates a pitch document at .specs/{feature}/pitch.md defining a problem domain with constraints, appetite, and solution shape. Use to frame a feature before writing a spec.
Use when user wants to Creates a technical plan at .specs/{feature}/plan.md translating a spec's functional requirements into architecture, technology, and code decisions.
Use when user wants to Creates a lightweight experiment document at .specs/sketches/{slug}.md to test a technical hypothesis before committing to a larger initiative.
Use when user wants to Creates a full functional specification at .specs/{feature}/spec.md defining what a system does and why. Use to write or revise feature requirements.
| name | trellis:guidelines |
| description | Creates or updates .specs/guidelines.md with project-wide stack, conventions, and principles. Use when starting a project or when a fundamental technology decision has changed. |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash(git:*), Task |
Create or update the project guidelines document at .specs/guidelines.md.
Recommended effort: medium. Interview-driven with structured generation into a fixed section template.
Run python3 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-prereqs.py guidelines and use the specsDir value from the JSON output. Abort if the output reports missing prerequisites.
This skill operates in two modes depending on whether .specs/guidelines.md already exists.
If .specs/guidelines.md does not exist, this is a fresh project. Ask the user:
npm run lint && npm run typecheck && npm run build && npm run test, or ruff check . && mypy . && pytest)If the user provides a description or the project already has code, infer what you can and confirm with them.
If .specs/guidelines.md already exists, read it first. Then ask the user:
After gathering all user input via the interview, spawn the guideliner agent. Pass it: the specs directory path and all interview responses. The agent will generate the guidelines document.