OpenAgentsControl Prompt模板

Step 1: Install

One command:

curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh | bash -s developer

_{The installer will set up OpenCode CLI if you don't have it yet.}

Or interactive:

curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/install.sh -o install.sh
bash install.sh

Step 2: Start Building

opencode --agent OpenAgent
> "Create a user authentication system"

Or: nano ~/.config/opencode/agent/core/opencoder.md # global install

SystemBuilder (Custom AI Systems)

Best for: Building complete custom AI systems tailored to your domain

opencode --agent SystemBuilder
> "Create a customer support AI system"

Interactive wizard generates orchestrators, subagents, context files, workflows, and commands.

Perfect for: Creating domain-specific AI systems

---

Or: nano ~/.config/opencode/agent/core/opencoder.md # global install

```

Change the model in the frontmatter:

System Builder

Build complete custom AI systems tailored to your domain in minutes. Interactive wizard generates orchestrators, subagents, context files, workflows, and commands.

---

Getting Started

Q: Does this work on Windows? A: Yes! Use Git Bash (recommended) or WSL.

Q: What languages are supported? A: Agents are language-agnostic and adapt based on your project files. Primarily tested with TypeScript/Node.js. C# / .NET is now supported with dedicated context files. Python, Go, Rust, and other languages are supported but less battle-tested. The context system works with any language.

Q: Do I need to add context? A: No, but it's highly recommended. Without context, agents write generic code. With context, they write YOUR code.

Q: Can I use this without customization? A: Yes, it works out of the box. But you'll get the most value after adding your patterns (10-15 minutes with /add-context).

Q: What models are supported? A: Any model from any provider (Claude, GPT, Gemini, MiniMax, local models). No vendor lock-in.

Setup

Q: What bash version do I need? A: Bash 3.2+ (macOS default works). Run bash scripts/tests/test-compatibility.sh to check.

Q: Do I need to install plugins/tools? A: No, they're optional. Only install if you want Telegram notifications or Gemini AI features.

Q: Where should I install - globally or per-project? A: Local (.opencode/ in your project) is recommended — patterns are committed to git and shared with your team. Global (~/.config/opencode/) is good for personal defaults across all projects. The installer asks you to choose. See OpenCode Config Docs for how configs merge.

---

🚀 Quick Start

Prerequisites: OpenCode CLI (free, open-source) • Bash 3.2+ • Git

💻 Example Workflow

opencode --agent OpenCoder
> "Create a user dashboard with authentication and profile settings"

What happens:

1. Discover (~1-2 min) - ContextScout finds relevant patterns - Your tech stack (Next.js + TypeScript + PostgreSQL) - Your API pattern (Zod validation, error handling) - Your component pattern (functional, TypeScript, Tailwind) - Your naming conventions (kebab-case files, PascalCase components)

2. Propose (~2-3 min) - Agent creates detailed implementation plan ```

⚙️ Advanced Configuration

Model Configuration (Optional)

By default, all agents use your OpenCode default model. Configure models per agent only if you want different agents to use different models.

When to configure: - You want faster agents to use cheaper models (e.g., Haiku/Flash) - You want complex agents to use smarter models (e.g., Opus/GPT-5) - You want to test different models for different tasks

How to configure:

Edit agent files directly: ```bash nano .opencode/agent/core/opencoder.md # local project install

The Workflow

1. Add Your Context (one time)
   ↓
2. ContextScout discovers relevant patterns
   ↓
3. Agent loads YOUR standards
   ↓
4. Agent proposes plan (using your patterns)
   ↓
5. You approve
   ↓
6. Agent implements (matches your project)
   ↓
7. Code ships (no refactoring needed)

Add project rules, change workflows, customize behavior

```

3. ExternalScout - Live Documentation 🆕 Working with external libraries? ExternalScout fetches current documentation: - Gets live docs from official sources (npm, GitHub, docs sites) - No outdated training data - always current - Automatically triggered when agents detect external dependencies - Supports frameworks, APIs, libraries, and more

4. Approval Gates - No Surprises Agents ALWAYS request approval before: - Writing/editing files - Running bash commands - Delegating to subagents - Making any changes

You stay in control. Review plans before execution.

5. MVI Principle - Token Efficiency Files designed for quick loading: - Concepts: <100 lines - Guides: <150 lines - Examples: <80 lines

Result: Lower token usage vs loading entire codebase.

6. Team Patterns - Repeatable Results Store patterns in .opencode/context/project/. Commit to repo. Entire team uses same standards. New developers inherit patterns automatically.

---

Frontend Design Workflow

The OpenFrontendSpecialist follows a structured 4-stage design workflow: 1. Layout - ASCII wireframe, responsive structure planning 2. Theme - Design system selection, OKLCH colors, typography 3. Animation - Micro-interactions, timing, accessibility 4. Implementation - Single HTML file, semantic markup

🆚 Quick Comparison

Use OAC when: - ✅ You have established coding patterns - ✅ You want code that ships without refactoring - ✅ You need approval gates for quality control - ✅ You care about token efficiency and costs

Use others when: - Cursor/Copilot: Quick prototypes, don't care about patterns - Aider: Simple file edits, no team coordination - Oh My OpenCode: Need autonomous execution with parallel agents (speed over control)

Full comparison: Read detailed analysis →

---

Alternative: Claude Code Plugin (BETA)

Prefer Claude Code? OpenAgents Control is also available as a Claude Code plugin!

Installation:

1. Register the marketplace:

/plugin marketplace add darrenhinde/OpenAgentsControl

2. Install the plugin:

/plugin install oac

3. Download context files:

/oac:setup --core

4. Start building:

Add a login endpoint

Features: - ✅ 6-stage workflow with approval gates - ✅ Context-aware code generation - ✅ 7 specialized subagents (task-manager, context-scout, context-manager, coder-agent, test-engineer, code-reviewer, external-scout) - ✅ 9 workflow skills + 6 user commands - ✅ Flexible context discovery (.oac config, .claude/context, context, .opencode/context) - ✅ Add context from GitHub, worktrees, local files, or URLs - ✅ Easy feature planning with /oac:plan

Documentation: - Plugin README - Complete plugin documentation - First-Time Setup - Step-by-step guide - Quick Start - Quick reference

Status: BETA - Actively tested and ready for early adopters

---

Comparison

Q: How is this different from Cursor/Copilot? A: OAC has editable agents (not baked-in), approval gates (not auto-execute), context system (YOUR patterns), and MVI token efficiency.

Q: How is this different from Aider? A: OAC has team patterns, context system, approval workflow, and smart pattern discovery. Aider is file-based only.

Q: How does this compare to Oh My OpenCode? A: Both are built on OpenCode. OAC focuses on control & repeatability (approval gates, pattern control, team standards). Oh My OpenCode focuses on autonomy & speed (parallel agents, auto-execution). Read detailed comparison →

Q: When should I NOT use OAC? A: If you want fully autonomous execution without approval gates, or if you don't have established coding patterns yet.

Answers questions with team standards

❓ FAQ