From baae4f603357f4fd42a3a5b4f75bf5d9a5aeee0e Mon Sep 17 00:00:00 2001
From: zlei9 <zlei9@126.com>
Date: Sun, 29 Mar 2026 10:21:18 +0800
Subject: [PATCH] Initial commit with translated description

---
 SKILL.md                         | 77 ++++++++++++++++++++++++++++++++
 _meta.json                       |  6 +++
 assets/operator-prompts.md       | 14 ++++++
 references/command-cheatsheet.md | 13 ++++++
 references/failure-handling.md   | 13 ++++++
 references/model-selection.md    | 15 +++++++
 references/plan-vs-build.md      | 17 +++++++
 references/question-handling.md  |  8 ++++
 references/session-management.md | 10 +++++
 references/workflow.md           | 12 +++++
 10 files changed, 185 insertions(+)
 create mode 100644 SKILL.md
 create mode 100644 _meta.json
 create mode 100644 assets/operator-prompts.md
 create mode 100644 references/command-cheatsheet.md
 create mode 100644 references/failure-handling.md
 create mode 100644 references/model-selection.md
 create mode 100644 references/plan-vs-build.md
 create mode 100644 references/question-handling.md
 create mode 100644 references/session-management.md
 create mode 100644 references/workflow.md

diff --git a/SKILL.md b/SKILL.md
new file mode 100644
index 0000000..63d3232
--- /dev/null
+++ b/SKILL.md
@@ -0,0 +1,77 @@
+---
+name: opencode-controller
+description: "通过斜杠命令控制和操作Opencode。"
+---
+
+# Opencode Controller
+
+## Core rule
+
+Clawdbot does not write code.
+All planning and coding happens inside Opencode.
+
+## Pre-flight
+
+- Ask the user which AI provider to use.
+- Ask how the provider should be authenticated.
+- Do not proceed without confirmation.
+
+## Session management
+
+- Start Opencode.
+- Open session selector using:
+  /sessions
+- If the current project already exists:
+  - Select the existing session.
+- Never create a new session without user approval.
+
+## Agent (mode) control
+
+- Open agent selector using:
+  /agents
+- Available agents:
+  - Plan
+  - Build
+- Always select Plan first.
+- Switch agents whenever required using `/agents`.
+
+## Model selection
+
+- Open model selector using:
+  /models
+- Select the user-requested provider.
+- If authentication is required:
+  - Copy the login link provided by Opencode.
+  - Send it to the user.
+  - Wait for confirmation before continuing.
+
+## Plan agent behavior
+
+- Ask Opencode to analyze the task.
+- Request a clear step-by-step plan.
+- Allow Opencode to ask clarification questions.
+- Review the plan carefully.
+- If the plan is incorrect or incomplete:
+  - Ask Opencode to revise it.
+- Do not allow code generation in Plan.
+
+## Build agent behavior
+
+- Switch to Build using `/agents`.
+- Ask Opencode to implement the approved plan.
+- If Opencode asks any question:
+  - Immediately switch back to Plan.
+  - Answer and confirm the plan.
+  - Switch back to Build.
+
+## Completion
+
+- Repeat the Plan → Build loop until all user requirements are satisfied.
+- Never skip Plan.
+- Never answer questions in Build.
+
+## Output format
+
+- Show all slash commands explicitly.
+- State which option is selected.
+- Provide login links verbatim.
diff --git a/_meta.json b/_meta.json
new file mode 100644
index 0000000..af1927c
--- /dev/null
+++ b/_meta.json
@@ -0,0 +1,6 @@
+{
+  "ownerId": "kn76x9kj4xk50a8zzc3j64vx1180396s",
+  "slug": "opencode-controller",
+  "version": "1.0.0",
+  "publishedAt": 1769633853391
+}
\ No newline at end of file
diff --git a/assets/operator-prompts.md b/assets/operator-prompts.md
new file mode 100644
index 0000000..d54dc4e
--- /dev/null
+++ b/assets/operator-prompts.md
@@ -0,0 +1,14 @@
+### Ask for provider
+Which AI provider do you want to use in Opencode?
+
+### Ask for auth
+How should Opencode authenticate (auth, key, local)?
+
+### Plan request
+Analyze the task and propose a step-by-step plan. Ask clarification questions if needed.
+
+### Plan revision
+The plan has issues. Please revise it.
+
+### Build request
+Proceed with implementation based on the approved plan.
diff --git a/references/command-cheatsheet.md b/references/command-cheatsheet.md
new file mode 100644
index 0000000..7b58d91
--- /dev/null
+++ b/references/command-cheatsheet.md
@@ -0,0 +1,13 @@
+## Core Opencode commands
+
+- Start Opencode:
+  opencode
+
+- Session selection:
+  /sessions
+
+- Agent (mode) selection:
+  /agents
+
+- Model selection:
+  /models
diff --git a/references/failure-handling.md b/references/failure-handling.md
new file mode 100644
index 0000000..d7cb633
--- /dev/null
+++ b/references/failure-handling.md
@@ -0,0 +1,13 @@
+## Common failures and responses
+
+### Login link does not work
+- Ask the user to retry
+- Do not proceed without confirmation
+
+### Model not available
+- Inform the user
+- Ask for an alternative provider
+
+### Plan is unclear or contradictory
+- Ask Opencode to rewrite the plan
+- Do not switch to Build mode
diff --git a/references/model-selection.md b/references/model-selection.md
new file mode 100644
index 0000000..df276e5
--- /dev/null
+++ b/references/model-selection.md
@@ -0,0 +1,15 @@
+## Model selection procedure
+
+- Open model selector with:
+  /models
+
+- Select the provider requested by the user
+
+### Auth-based providers (e.g. OpenAI)
+
+- Opencode will generate a login URL
+- Copy the URL exactly
+- Send it to the user
+- Wait for confirmation before continuing
+
+Never assume authentication is complete.
diff --git a/references/plan-vs-build.md b/references/plan-vs-build.md
new file mode 100644
index 0000000..3898314
--- /dev/null
+++ b/references/plan-vs-build.md
@@ -0,0 +1,17 @@
+## Plan mode
+
+- Thinking only
+- Planning
+- Asking questions
+- Revising approach
+- No code generation
+
+## Build mode
+
+- Code implementation
+- Execution of approved plan
+
+### Mode switching
+
+- Use the Tab key to toggle modes
+- Always start in Plan mode
diff --git a/references/question-handling.md b/references/question-handling.md
new file mode 100644
index 0000000..3792c20
--- /dev/null
+++ b/references/question-handling.md
@@ -0,0 +1,8 @@
+## Handling questions from Opencode
+
+- If Opencode asks a question:
+  - Switch to Plan mode immediately
+  - Answer carefully
+  - Confirm or revise the plan
+
+Never answer questions in Build mode.
diff --git a/references/session-management.md b/references/session-management.md
new file mode 100644
index 0000000..a199580
--- /dev/null
+++ b/references/session-management.md
@@ -0,0 +1,10 @@
+## Session rules
+
+- Opencode keeps a history of projects
+- The same project must always use the same session
+- Reusing sessions preserves context and decisions
+- Starting a new session is allowed only if the user explicitly asks
+- Open session selector using:
+  /sessions
+
+If unsure, ask the user before creating a new session.
diff --git a/references/workflow.md b/references/workflow.md
new file mode 100644
index 0000000..cf61480
--- /dev/null
+++ b/references/workflow.md
@@ -0,0 +1,12 @@
+## Standard workflow
+
+1. Confirm AI provider and auth method with the user
+2. Start Opencode
+3. Reuse existing project session if present
+4. Select AI model using `/models`
+5. Ensure Plan mode
+6. Generate and validate plan
+7. Switch to Build mode
+8. Implement
+9. Handle interruptions by returning to Plan mode
+10. Repeat until finished