specline 1.4.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Specline
 
-面向 Cursor IDE 的 **Spec 驱动 AI 编码流水线**，内置确定性质量门禁。
+**Spec 驱动 AI 编码流水线**，内置确定性质量门禁。
 
 自然语言需求 → 自动走完 编写规格 → 编码 → 审查 → 测试 → 归档 全流程：
 
@@ -14,6 +14,21 @@
 /specline-quickfix "修复登录按钮样式"
 ```
 
+整理面向 AI 的项目知识库？一个命令搞定：
+
+```
+/specline-knowledge
+```
+
+## 支持平台
+
+| 平台 | 状态 | 说明 |
+|------|------|------|
+| **Cursor** | ✅ 完整支持 | Skills + Agents + Hooks 原生集成 |
+| **Claude Code** | ✅ 完整支持 | Skills + Agents + settings.json hooks |
+| **Codex** | ✅ 完整支持 | Skills + TOML Agents + hooks.json |
+| **OpenCode** | ✅ 完整支持 | Skills + Plugin + prompt 内嵌 agents |
+
 ## 它能做什么
 
 **完整流水线**（新功能、重构）：
@@ -38,14 +53,14 @@
 ## 核心特性
 
 - **需求驱动**：自然语言 → 结构化规格文档（Requirements + Scenarios + WHEN/THEN）
+- **跨平台**：同一套 Spec 驱动流水线，适配 Cursor / Claude Code / Codex / OpenCode
 - **并行编码**：自动按前端/后端/config 拆分任务，同批次并发派发 Coding Agent
 - **TDD 白盒测试**：无依赖任务自动启用 TDD 模式（先写单测 → 确认失败 → 最小实现 → 重构），与黑盒 test-writer 并行协作
 - **确定性门禁**：每个阶段用 Shell 脚本的退出码判定是否通过，不做模糊判断
 - **黑盒测试**：测试 Agent 只看 Spec 文档，不能读取任何实现源码
 - **断点续跑**：随时中断，下次从最后一个可信门禁自动恢复（tasks.md 的 `[x]`/`[ ]` 标记进度）
-- **人机协作**：3 个人工检查点——Spec 确认、Review 可选复核、归档确认，支持 `full`/`minimal`/`none` 三级自动化策略配置（`specline/config.yaml` 中 `pipeline.human_gate_policy`）
-- **Hook 约束体系**：sessionStart 注入 pipeline 上下文 → preToolUse 违规拦截 → postToolUse 操作后提醒，确保长对话中 Agent 不偏离流水线逻辑
-- **安全 Hook**：自动拦截危险 Shell 命令（如 `rm -rf`、`curl|bash`）+ 代码变更后自动格式化
+- **人机协作**：3 个人工检查点——Spec 确认、Review 可选复核、归档确认，支持 `full`/`minimal`/`none` 三级自动化策略配置
+- **AI 知识库**：自动检测、生成、更新六类项目知识文件（术语表/架构/约定/决策/参考/操作指南）
 - **零外部依赖**：不依赖 OpenSpec CLI，全部功能自包含
 
 ## 快速开始
@@ -54,44 +69,88 @@
 # 全局安装
 npm install -g specline
 
-# 在项目中初始化
+# 在项目中初始化（交互式选择平台）
 cd my-project
 specline init
 
+# 指定平台初始化
+specline init --platform cursor
+specline init --platform cursor,claude
+specline init --platform all
+
 # 或者用 npx（无需安装）
-npx specline init
+npx specline init --platform cursor
+```
+
+### `--platform` 参数
+
+| 值 | 说明 |
+|----|------|
+| `cursor` | 部署 Cursor IDE 集成（默认） |
+| `claude` | 部署 Claude Code 集成 |
+| `codex` | 部署 Codex 集成 |
+| `opencode` | 部署 OpenCode 集成 |
+| `all` | 部署全部平台 |
+
+TTY 环境下不指定 `--platform` 时进入交互式多选界面；非 TTY 环境默认 `cursor`。
+
+## Upgrading
 
-# 检查 CLI 更新
-specline update
+```bash
+# 升级 CLI 到最新版本
+npm update -g specline
 
-# 同步项目模板文件到最新版本
+# 同步项目文件到最新模板
 specline sync
-specline sync --dry-run    # 预览变更
+
+# 预览同步变更（不实际写入）
+specline sync --dry-run
 ```
 
-初始化后项目会获得完整的流水线基础设施：
+v1 用户升级到 v2 详见 [迁移指南](docs/migration/v1-to-v2.md)。
+
+## 架构
 
 ```
-my-project/
-├── .cursor/
-│   ├── agents/          ← 9 个 Specline Agent 定义
-│   ├── commands/        ← 3 个 Slash 命令入口
-│   ├── skills/          ← 6 个 Skill 指令
-│   │   └── specline-pipeline/
-│   │       ├── SKILL.md         ← 核心编排指令（~500 行）
-│   │       ├── templates/       ← 子 Agent prompt 模板
-│   │       └── references/      ← Schema / 事件日志 / 约束参考文档
-│   ├── hooks/           ← 7 个 Gate/Hook 脚本
-│   └── hooks.json       ← Cursor Hook 配置
-├── specline/            ← 运行时目录
-│   ├── config.yaml      ← 项目配置（含 pipeline 人机门禁策略）
-│   ├── changes/         ← 变更目录
-│   │   └── archive/     ← 归档目录
-│   └── specs/           ← 主规格目录
-└── .specline-config.yaml
+specline init --platform <list>
+    │
+    ▼
+┌─────────────────────────────────────────────────────────────┐
+│  core/                        ← 平台无关的源文件             │
+│  ├── skills/                  ← 7 个 Skill（含模板变量）     │
+│  ├── agents/                  ← Agent YAML Canonical        │
+│  ├── gates/                   ← 确定性门禁脚本              │
+│  ├── hooks/                   ← SessionStart hook 源       │
+│  └── bootstrap/               ← 通用 bootstrap 文档        │
+├─────────────────────────────────────────────────────────────┤
+│  adapters/<platform>/         ← 平台特定配置                │
+│  ├── deploy.json              ← 部署描述（目录/格式/变量）   │
+│  ├── hooks.json               ← 平台 Hook 配置             │
+│  └── orchestration.md         ← 工具映射参考                │
+├─────────────────────────────────────────────────────────────┤
+│  lib/                         ← CLI 模块                    │
+│  ├── render.mjs               ← Skill/Agent 渲染器         │
+│  ├── deploy.mjs               ← 单平台部署逻辑             │
+│  ├── lock.mjs                 ← Lock file v2 读写          │
+│  └── ...                                                    │
+└─────────────────────────────────────────────────────────────┘
+    │
+    ▼ 渲染 + 部署
+┌─────────────────────────────────────────────────────────────┐
+│  项目目录                                                    │
+│  ├── .cursor/   (Cursor)                                    │
+│  ├── .claude/   (Claude Code)                               │
+│  ├── .agents/   (Codex)                                     │
+│  ├── .opencode/ (OpenCode)                                  │
+│  └── specline/  ← 运行时（跨平台共享）                       │
+│      ├── config.yaml                                        │
+│      ├── platforms.yaml                                     │
+│      ├── changes/                                           │
+│      └── bin/gate.sh                                        │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-然后在 Cursor 中输入：
+初始化后在对应平台中输入：
 
 ```
 /specline-pipeline "添加 JWT 用户认证"
@@ -109,6 +168,12 @@ my-project/
 /specline-explore
 ```
 
+让 AI 理解你的项目：
+
+```
+/specline-knowledge
+```
+
 ## 工作流选择
 
 Specline 提供两种工作流，按变更规模选择：
@@ -136,14 +201,14 @@ PHASE 1: SPEC（规格）
     ├── design.md      — 技术设计（架构/数据流/决策）
     └── tasks.md       — 任务清单（Type/Depends/Covers/Testable/Files + [ ] 进度标记）
   → specline-spec-reviewer 审核
-  → Gate: grep + jq 格式校验 + semantic 语义检查（Covers 引用悬空 / 依赖环路 / 异常场景缺失 / 模糊需求检测）
-  → 🟡 人工确认 Spec 和任务规划（策略可配：`full` 需确认 / `minimal` `none` 自动通过）
+  → Gate: grep + jq 格式校验 + semantic 语义检查
+  → 🟡 人工确认 Spec 和任务规划
 
 PHASE 2: CODING（编码）
   解析 tasks.md → 按依赖 DAG 分层 → 同批次前后端/config Agent 并发
   无依赖 + 可测试任务 → 自动启用 TDD 模式（RED-GREEN-REFACTOR）
   每完成一个任务，[ ] 自动标记为 [x]
-  → Gate: 编译检查（tsc --noEmit / python -m compileall） + 单元测试文件存在性检查
+  → Gate: 编译检查 + 单元测试文件存在性检查
 
 PHASE 3: REVIEW（审查）
   specline-code-reviewer + specline-config-reviewer 分别审查代码和配置/文档
@@ -151,98 +216,54 @@ PHASE 3: REVIEW（审查）
 
 PHASE 4: TEST（测试）
   单元测试 → 集成测试 → E2E 测试（黑盒，只看 Spec）
-  → config/docs 变更自动跳过测试
-  → 失败自动分析：测试写错了 / 代码写错了 / Spec 模糊
-  → 自动重试最多 2 次
+  → 失败自动分析 + 自动重试最多 2 次
 
 PHASE 5: ARCHIVE（归档）
-  → 🟡 人工确认归档（策略可配：`full` `minimal` 需确认 / `none` 自动归档）
+  → 🟡 人工确认归档
   → delta specs 合并到主规格目录
   → 按日期归档到 specline/changes/archive/
   ✅ 完成
-
-### TDD 白盒测试
-
-Pipeline 采用「两层测试分离」架构：
-
-```
-Coding Agent（白盒 TDD）              Test-Writer（黑盒）
-─────────────────────────            ─────────────────
-产出: tests/unit/**                  产出: tests/integration/**
-      tests/models/**                      tests/e2e/**
-测试: 单个函数的输入输出              测试: 跨模块的用户行为
-      边界条件、异常路径                     API 端到端契约
-      Spec Scenario 全覆盖
-触发: 编码时同步产出                   触发: Phase 2 与 Coding 并行启动
-      先写测试 → 确认失败 → 写实现        只读 Spec，不读源码
-```
-
-tasks.md 中 `Testable: true` 的任务自动启用 TDD 模式（完整 RED-GREEN-REFACTOR 循环），`Testable: false` 的任务保持原有流程。两个测试域严格目录隔离，冲突检测自动识别越界。
-```
-
-## 轻量修复流程
-
-```
-PHASE 1: UNDERSTAND（理解）
-  读取相关代码 → 理解上下文 → 意图模糊时 AskUserQuestion 确认
-
-PHASE 2: IMPLEMENT（实现）
-  直接 Write/StrReplace 编辑 1-3 个文件
-  不需要 Spec 文档、DAG 构建、批次调度
-
-PHASE 3: REVIEW（审查）
-  ReadLints 检查 + 自动修复（最多 2 次）→ Agent 自审逻辑正确性
-
-PHASE 4: TEST（测试）
-  仅运行项目已有单元测试，无测试则跳过
-  失败自动修复最多 2 次
-
-PHASE 5: ARCHIVE（归档）
-  生成 summary.md + files-changed.json → 询问是否 git commit
-```
-
-## 架构
-
-```
-/specline-pipeline       ← 完整流水线（大功能）    /specline-quickfix    ← 轻量修复（小改动）
-    │                                                  │
-    ▼                                                  ▼
-specline-pipeline SKILL  ← 编排层                 编排者直接执行（无子 Agent）
-    │                                               Read → Write → ReadLints → Shell → 归档
-    ├── SKILL.md           核心编排指令（~500 行）
-    ├── templates/         subagent-prompts.md（3 套 prompt 模板）
-    └── references/        Schema / 事件日志 / 约束参考文档
-    │
-┌───┼──────────────────┬──────────────────────┐
-▼   ▼                  ▼                      ▼
-9 个子 Agent      specline-pipeline-     Cursor Hooks
-（创造性工作）      gate.sh              （安全网 + 约束）
-                  （确定性门禁）
 ```
 
 ## CLI 命令
 
 | 命令 | 说明 |
 |------|------|
-| `specline init [path]` | 在指定路径（默认当前目录）初始化 Specline 项目，复制模板文件并生成锁文件 |
-| `specline update` | 检查 CLI 是否有新版本可用（npm registry），输出更新提示 |
-| `specline sync [--dry-run] [path]` | 将上游最新模板文件同步到项目，基于 Lock File 智能识别安全更新/冲突/仅本地修改。hooks.json 语义合并（保留用户自定义 hook）、config.yaml 注释级更新（保留用户配置值）、CONFLICT 覆盖前自动创建 `.orig` 备份。`--dry-run` 预览变更不实际写入 |
-| `specline --version` | 显示当前 CLI 版本号 |
+| `specline init [--platform <list>]` | 初始化 Specline 项目，支持多平台部署 |
+| `specline sync [--dry-run] [--platform <list>]` | 同步模板文件到最新版本 |
+| `specline gate <subcommand>` | Gate 门禁 CLI 包装（spec/build/lint/test/list） |
+| `specline hook session-start [--platform <p>]` | 跨平台 SessionStart hook |
+| `specline platforms` | 查看已部署平台列表 |
+| `specline update` | 检查 CLI 新版本 |
+| `specline --version` | 显示版本号 |
 | `specline --help` | 显示帮助信息 |
 
 ## 子 Agent 列表
 
 | Agent | 职责 |
 |-------|------|
-| `specline-spec-creator` | 根据自然语言需求，基于内联模板直接生成 proposal/design/tasks/spec 四个文件 |
+| `specline-spec-creator` | 根据自然语言需求生成 proposal/design/tasks/spec |
 | `specline-spec-reviewer` | 审核规格的完整性、一致性和覆盖度 |
-| `specline-frontend-dev` | UI 组件、页面、样式、交互逻辑（单个任务级别，Testable 任务启用 TDD） |
-| `specline-backend-dev` | API 端点、数据模型、业务逻辑（单个任务级别，Testable 任务启用 TDD） |
-| `specline-config-dev` | Shell 脚本、配置文件（JSON/YAML）、Markdown 文档（处理 Type: config/docs 任务） |
-| `specline-code-reviewer` | 前端/后端代码质量、安全性、可维护性审查 |
-| `specline-config-reviewer` | Shell 脚本安全性、配置文件语法和一致性、Markdown 文档结构审查 |
-| `specline-test-writer` | 黑盒测试编写——只能看 Spec 不能读源码，仅写集成测试（tests/integration/）和 E2E 测试 |
-| `specline-test-runner` | 执行测试并分类失败原因（测试问题/代码问题/Spec 模糊），区分单元测试（回 coding agent）和集成/E2E 测试（回 test-writer） |
+| `specline-frontend-dev` | UI 组件、页面、样式、交互逻辑 |
+| `specline-backend-dev` | API 端点、数据模型、业务逻辑 |
+| `specline-config-dev` | Shell 脚本、配置文件、Markdown 文档 |
+| `specline-code-reviewer` | 代码质量、安全性、可维护性审查 |
+| `specline-config-reviewer` | 配置文件语法、Shell 脚本安全性审查 |
+| `specline-test-writer` | 黑盒测试编写（只看 Spec 不读源码） |
+| `specline-test-runner` | 执行测试并分类失败原因 |
+| `specline-explore-assistant` | 设计压力测试，辅助探索模式 |
+
+## Skills 列表
+
+| Skill | 入口 | 说明 |
+|-------|------|------|
+| `specline-pipeline` | `/specline-pipeline <需求>` | 完整开发流水线编排 |
+| `specline-quickfix` | `/specline-quickfix <描述>` | 轻量修复（1-3 文件） |
+| `specline-propose` | 由 pipeline 调度 | 生成 Spec 规划文件 |
+| `specline-apply-change` | 由 pipeline 调度 | 执行 tasks.md 中的任务 |
+| `specline-explore` | `/specline-explore` | 探索模式，思考伙伴 |
+| `specline-archive-change` | 由 pipeline 调度 | 归档完成的 Change |
+| `specline-knowledge` | `/specline-knowledge` | AI 知识库管理 |
 
 ## 确定性门禁
 
@@ -250,34 +271,20 @@ specline-pipeline SKILL  ← 编排层                 编排者直接执行（
 
 | 门禁 | 检查内容 |
 |------|---------|
-| Spec | 结构性检查（`grep` 检查章节完整性、WHEN/THEN 配对、字段格式）+ 语义检查（`semantic` 子命令：Covers 引用悬空、依赖环路、异常场景缺失、模糊需求、反向覆盖、Type-文件一致性，分 ERROR/WARNING/INFO 三级严重度） |
-| Build | `tsc --noEmit` / `python -m compileall` 编译检查 + Testable 任务单元测试文件存在性与语法检查 |
-| Lint | `ruff` / `eslint` 退出码 + code-review.json 中 error 数量 |
+| Spec | 结构性检查 + 语义检查（Covers 引用悬空、依赖环路、异常场景缺失、模糊需求） |
+| Build | 编译检查 + Testable 任务单元测试文件存在性 |
+| Lint | Linter 退出码 + code-review.json error 数量 |
 | Test | 测试框架退出码 + 覆盖率阈值 |
 | Archive | 归档目录结构 + 必要文件完整性 |
 
-## Hook 约束体系
-
-Specline 通过 Cursor Hooks 构建三层约束，确保长对话中 Agent 始终遵循流水线的阶段逻辑：
-
-| Hook | 时机 | 作用 |
-|------|------|------|
-| `sessionStart` | 新会话启动 | 扫描活跃 pipeline，自动注入阶段上下文到 Agent 系统提示 |
-| `preToolUse` | 工具调用前 | 阶段校验：SPEC 阶段拦截代码编辑、阶段不匹配的子 Agent 启动 |
-| `postToolUse` | 工具调用后 | 注入下一步提醒：更新 tasks.md checkbox、运行 Gate 脚本 |
-| `subagentStart` | 子 Agent 启动前 | 白名单 + 阶段匹配双校验 |
-| `beforeShellExecution` | Shell 命令执行前 | 拦截危险命令（`rm -rf`、`curl\|bash`、`sudo`） |
-| `afterFileEdit` | 文件编辑后 | 自动格式化代码 |
-
-> 非流水线会话完全透明——所有 Hook 第一步检查「是否有活跃 pipeline」，无则直接放行。
-
 ## 环境要求
 
-- **Cursor IDE**（支持 hooks 和 skills）
+- **Node.js** >= 20.0.0
 - **jq**（Gate 脚本 JSON 处理）
   - macOS 预装
   - Linux: `apt install jq`
   - Windows: `choco install jq`
+- **支持的 AI 编码平台**（至少一个）：Cursor / Claude Code / Codex / OpenCode
 
 ## License
 

package/adapters/claude/deploy.json

@@ -0,0 +1,12 @@
+{
+  "platform": "claude",
+  "skills_dir": ".claude/skills",
+  "agents_dir": ".claude/agents",
+  "agent_format": "md",
+  "hooks_file": ".claude/settings.json",
+  "vars": {
+    "DISPATCH": "使用 Agent 工具派发 {{ROLE}} 角色",
+    "CONFIRM": "在对话中向用户提问确认",
+    "LINT": "运行 linter 命令检查"
+  }
+}

package/adapters/claude/hooks/hooks.json

@@ -0,0 +1,12 @@
+{
+  "hooks": {
+    "SessionStart": [{
+      "matcher": "startup|resume",
+      "hooks": [{
+        "type": "command",
+        "command": "specline hook session-start --platform claude",
+        "timeout": 10
+      }]
+    }]
+  }
+}

package/adapters/claude/hooks.json

@@ -0,0 +1,12 @@
+{
+  "hooks": {
+    "SessionStart": [{
+      "matcher": "startup|resume",
+      "hooks": [{
+        "type": "command",
+        "command": "specline hook session-start --platform claude",
+        "timeout": 10
+      }]
+    }]
+  }
+}

package/adapters/claude/orchestration.md

@@ -0,0 +1,17 @@
+# Claude Code Orchestration Reference
+
+## Tool Mapping
+
+| Specline 抽象 | Claude Code 工具 |
+|--------------|-----------------|
+| 派发子 Agent | Agent 工具 / plugin agents |
+| 用户确认 | 对话中提问 |
+| Lint 检查 | bash 命令执行 linter |
+| 文件读取 | Read |
+| 文件编辑 | Write / Edit |
+| Shell 执行 | bash |
+| 搜索 | grep / find |
+
+## Notes
+- Claude Code 支持项目级 agents（.claude/agents/*.md）
+- Hook 通过 .claude/settings.json 的 hooks 段配置

package/adapters/codex/agent.toml.hbs

@@ -0,0 +1,7 @@
+name = "{{name}}"
+description = "{{description}}"
+
+[instructions]
+developer_instructions = """
+{{instructions}}
+"""

package/adapters/codex/deploy.json

@@ -0,0 +1,12 @@
+{
+  "platform": "codex",
+  "skills_dir": ".agents/skills",
+  "agents_dir": ".agents/agents",
+  "agent_format": "toml",
+  "hooks_file": ".codex/hooks.json",
+  "vars": {
+    "DISPATCH": "spawn {{ROLE}} agent with prompt:",
+    "CONFIRM": "在对话中向用户提问确认",
+    "LINT": "运行 linter 命令检查"
+  }
+}

package/adapters/codex/hooks.json

@@ -0,0 +1,12 @@
+{
+  "hooks": {
+    "SessionStart": [{
+      "matcher": "startup|resume",
+      "hooks": [{
+        "type": "command",
+        "command": "specline hook session-start --platform codex",
+        "statusMessage": "Loading Specline"
+      }]
+    }]
+  }
+}

package/adapters/codex/orchestration.md

@@ -0,0 +1,18 @@
+# Codex Orchestration Reference
+
+## Tool Mapping
+
+| Specline 抽象 | Codex 工具 |
+|--------------|-----------|
+| 派发子 Agent | spawn named agent / subagent |
+| 用户确认 | 对话 / CLI prompt |
+| Lint 检查 | bash 命令执行 linter |
+| 文件读取 | read |
+| 文件编辑 | apply_patch |
+| Shell 执行 | bash |
+| 搜索 | grep / glob |
+
+## Notes
+- Codex 支持 named agents（.agents/agents/*.toml）
+- Skills 自动扫描 .agents/skills/ 目录
+- SubagentStart 不能 deny，阶段约束靠 Skill + Gate

package/adapters/cursor/deploy.json

@@ -0,0 +1,12 @@
+{
+  "platform": "cursor",
+  "skills_dir": ".cursor/skills",
+  "agents_dir": ".cursor/agents",
+  "agent_format": "md",
+  "hooks_file": ".cursor/hooks.json",
+  "vars": {
+    "DISPATCH": "使用 Task 工具，subagent_type=\"{{ROLE}}\"",
+    "CONFIRM": "使用 AskUserQuestion 工具",
+    "LINT": "使用 ReadLints 工具"
+  }
+}

package/adapters/cursor/hooks.json

@@ -0,0 +1,9 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [{
+      "command": "specline hook session-start --platform cursor",
+      "timeout": 10
+    }]
+  }
+}

package/adapters/cursor/orchestration.md

@@ -0,0 +1,17 @@
+# Cursor Orchestration Reference
+
+## Tool Mapping
+
+| Specline 抽象 | Cursor 工具 |
+|--------------|------------|
+| 派发子 Agent | `Task(subagent_type="<role>")` |
+| 用户确认 | `AskUserQuestion` |
+| Lint 检查 | `ReadLints` |
+| 文件读取 | `Read` |
+| 文件编辑 | `Write` / `StrReplace` |
+| Shell 执行 | `Shell` |
+| 搜索 | `Grep` / `Glob` |
+
+## Notes
+- Cursor 支持命名 subagent 类型，直接映射到 .cursor/agents/*.md
+- SessionStart hook 通过 .cursor/hooks.json 配置

package/adapters/opencode/deploy.json

@@ -0,0 +1,12 @@
+{
+  "platform": "opencode",
+  "skills_dir": ".opencode/skills",
+  "agents_dir": null,
+  "agent_format": null,
+  "hooks_file": null,
+  "vars": {
+    "DISPATCH": "使用 task(subagent_type=\"general\") 并在 prompt 中内嵌 {{ROLE}} 的 instructions",
+    "CONFIRM": "在对话中向用户提问确认",
+    "LINT": "运行 linter 命令检查"
+  }
+}

package/adapters/opencode/orchestration.md

@@ -0,0 +1,18 @@
+# OpenCode Orchestration Reference
+
+## Tool Mapping
+
+| Specline 抽象 | OpenCode 工具 |
+|--------------|--------------|
+| 派发子 Agent | task(subagent_type="general") + prompt 内嵌 |
+| 用户确认 | 对话中提问 |
+| Lint 检查 | bash 命令执行 linter |
+| 文件读取 | read |
+| 文件编辑 | apply_patch |
+| Shell 执行 | bash |
+| 搜索 | grep / glob |
+
+## Notes
+- OpenCode 无命名 subagent 类型，role instructions 内嵌在 prompt 中
+- Skills 通过 plugin.js 注册 .opencode/skills/ 路径
+- Bootstrap 通过 experimental.chat.messages.transform hook 注入

package/adapters/opencode/plugin.js

@@ -0,0 +1,10 @@
+export default {
+  name: "specline",
+  config(ctx) {
+    return { skills: [".opencode/skills"] };
+  },
+  "experimental.chat.messages.transform"(messages, ctx) {
+    // Inject using-specline bootstrap on first message
+    return messages;
+  }
+};