@yee94/opencode-profile 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# OpenCode Yee Profile
+
+OpenCode V2 插件：保留原生 Build，按需使用 Explore、Oracle、Designer。无调度器、自动唤醒或模型降级链。
+
+## 使用
+
+需要 Node.js 24+、支持 `@opencode/plugin` 2.0.12 API 的 OpenCode V2。
+
+在 `opencode.jsonc` 中加入：
+
+```jsonc
+{
+  "plugins": ["@yee94/opencode-profile@0.1.0"]
+}
+```
+
+重新加载 OpenCode，新建 Build 会话。从 slim 迁移时，先移除旧插件条目。
+
+| Agent | 用途 |
+| --- | --- |
+| Build | 主执行者，提示词、模型和权限保持原样 |
+| Explore | 只读代码定位 |
+| Oracle | 只读架构审查：OCP、奥卡姆剃刀、YAGNI；合理即放行 |
+| Designer | UI/UX 设计与实现 |
+
+## 配置模型
+
+直接使用 OpenCode 原生配置。下面的模型 ID 为占位符，请替换为实际值：
+
+```jsonc
+{
+  "model": "your-provider/main-model",
+  "agents": {
+    "explore": { "model": "your-provider/fast-model" },
+    "oracle": { "model": "your-provider/review-model" },
+    "designer": { "model": "your-provider/design-model" }
+  }
+}
+```
+
+不指定子 Agent 模型时继承父会话模型；已配置的 Agent 模型会保留。当前会话的主模型在 `/models` 中选择。
+子 Agent 模型可追加 `#variant`，例如 `your-provider/review-model#high`，需模型本身支持。
+
+关闭某个专家时，使用插件选项：
+
+```jsonc
+{
+  "plugins": [{
+    "package": "@yee94/opencode-profile@0.1.0",
+    "options": { "agents": { "oracle": false } }
+  }]
+}
+```
+
+## 本地开发
+
+```sh
+pnpm install
+pnpm build
+pnpm check
+```
+
+将 `plugins` 中的包名替换为本仓库的绝对目录路径。修改后重新构建并重新加载插件。
+`pnpm smoke:host -- opencode2` 可在隔离环境验证真实宿主加载，不发模型请求。

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "@opencode/plugin";
+
+//#region src/index.d.ts
+declare const _default: Plugin.Plugin;
+//#endregion
+export { _default as default };

package/dist/index.mjs

@@ -0,0 +1,124 @@
+import { Model, Plugin } from "@opencode/plugin";
+import { z } from "zod";
+
+//#region src/options.ts
+const agentNames = [
+	"explore",
+	"oracle",
+	"designer"
+];
+const model = z.string().regex(/^[^\s/#]+\/[^\s#]+(?:#[^\s#]+)?$/, "Expected provider/model or provider/model#variant");
+const agentOptions = z.union([z.literal(false), z.strictObject({ model: model.optional() })]);
+const optionsSchema = z.strictObject({ agents: z.strictObject({
+	explore: agentOptions.optional(),
+	oracle: agentOptions.optional(),
+	designer: agentOptions.optional()
+}).default({}) });
+function parseOptions(input) {
+	const result = optionsSchema.safeParse(input ?? {});
+	if (!result.success) {
+		const problems = result.error.issues.map((issue) => `${issue.path.join(".") || "options"}: ${issue.message}`);
+		throw new Error(`Invalid opencode-yee-profile options:\n${problems.join("\n")}`);
+	}
+	return result.data;
+}
+
+//#endregion
+//#region src/agents.ts
+const specialists = {
+	explore: {
+		description: "Map unfamiliar code to file:line evidence. Skip for a known file or a single lookup.",
+		system: "Find the code that answers the question. Return file:line evidence and the relevant call path; stop when the question is answered, and label gaps.",
+		readonly: true
+	},
+	oracle: {
+		description: "Architecture-first review: OCP, Occam's razor, YAGNI, and justified extensibility. Focus on material structural costs, not speculative defenses or routine sign-off.",
+		system: "Read project conventions; assess existing layers, ownership, reuse, and real requirements. Apply Occam's razor and YAGNI: the simplest sufficient design with justified OCP extension points, not speculative frameworks. Accept reasonable trade-offs and necessary safeguards. Report only material issues with file:line evidence, costs, and minimal compatible fixes; otherwise approve and stop.",
+		readonly: true
+	},
+	designer: {
+		description: "Design and implement UI changes; use for visual or interaction decisions, not backend work.",
+		system: "Design and implement within the existing visual language. Make hierarchy, responsive behavior, accessibility, and interaction states intentional; verify the changed experience and report unverified states.",
+		readonly: false
+	}
+};
+function readOnlyPermissions() {
+	return [
+		{
+			action: "*",
+			resource: "*",
+			effect: "deny"
+		},
+		...[
+			"read",
+			"glob",
+			"grep"
+		].map((action) => ({
+			action,
+			resource: "*",
+			effect: "allow"
+		})),
+		{
+			action: "external_directory",
+			resource: "*",
+			effect: "ask"
+		},
+		{
+			action: "read",
+			resource: "*.env",
+			effect: "ask"
+		},
+		{
+			action: "read",
+			resource: "*.env.*",
+			effect: "ask"
+		},
+		{
+			action: "read",
+			resource: "*.env.example",
+			effect: "allow"
+		}
+	];
+}
+
+//#endregion
+//#region src/register.ts
+function registerAgents(editor, options) {
+	const build = editor.get("build");
+	if (!build || build.hidden || build.mode === "subagent") throw new Error("opencode-yee-profile requires the native, visible Build primary agent. Enable Build before loading this plugin.");
+	editor.default("build");
+	for (const name of agentNames) {
+		const settings = options.agents[name];
+		if (settings === false) {
+			editor.remove(name);
+			continue;
+		}
+		const specialist = specialists[name];
+		editor.update(name, (agent) => {
+			agent.mode = "subagent";
+			agent.hidden = false;
+			agent.description = specialist.description;
+			agent.system = specialist.system;
+			if (settings?.model) agent.model = Model.Ref.parse(settings.model);
+			if (specialist.readonly) agent.permissions = readOnlyPermissions();
+			else agent.permissions = [...agent.permissions.filter((rule) => rule.action !== "subagent"), {
+				action: "subagent",
+				resource: "*",
+				effect: "deny"
+			}];
+		});
+	}
+}
+
+//#endregion
+//#region src/index.ts
+var src_default = Plugin.define({
+	id: "opencode-yee-profile",
+	async setup(context) {
+		const options = parseOptions(context.options);
+		await context.agent.transform((editor) => registerAgents(editor, options));
+	}
+});
+
+//#endregion
+export { src_default as default };

package/index.js

@@ -0,0 +1 @@
+export { default } from './dist/index.mjs';

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@yee94/opencode-profile",
+  "version": "0.1.0",
+  "description": "Build-first OpenCode V2 plugin: small specialist prompts, no orchestration runtime",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "packageManager": "pnpm@10.28.2",
+  "engines": {
+    "node": ">=24",
+    "pnpm": ">=10"
+  },
+  "exports": {
+    ".": "./dist/index.mjs"
+  },
+  "files": [
+    "index.js",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "check": "pnpm lint && pnpm build && pnpm type-check && pnpm test && pnpm smoke",
+    "smoke": "node scripts/smoke.mjs",
+    "smoke:host": "node scripts/host-smoke.mjs",
+    "prepublishOnly": "pnpm check"
+  },
+  "dependencies": {
+    "zod": "^4.1.13"
+  },
+  "peerDependencies": {
+    "@opencode/plugin": "^2.0.12"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.13",
+    "@opencode/client": "2.0.12",
+    "@opencode/plugin": "2.0.12",
+    "@types/node": "^24.10.1",
+    "tsdown": "0.17.2",
+    "typescript": "5.9.3",
+    "vitest": "4.0.15"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yee94/opencode-yee-profile.git"
+  },
+  "license": "MIT"
+}