Files
beaver_project/docs/superpowers/plans/2026-06-04-initial-multi-search-engine.md
steven_li 2c5205b06e feat: 添加MinIO文件系统支持并优化外部连接器功能
- 添加MinIO用户文件系统配置选项(BEAVER_MINIO_ROOT_USER等)
- 更新外部连接器配置结构,包括BASE_URL和认证令牌设置
- 改进connector provider支持更多类型(official, feishu_bot等)
- 实现Mistral模型推理模式支持reasoning_effort参数
- 增强外部连接器策略配置和运行时配置管理
- 添加connector bridge事件验证和安全保护机制
- 优化任务路由逻辑,区分simple_chat和new_task场景
- 更新初始技能工具提示配置,分离authoring admin功能
2026-06-05 11:46:40 +08:00

105 lines
3.1 KiB
Markdown

# Initial Multi Search Engine Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Replace the initial `web-operation` skill with SkillHub `multi-search-engine` while keeping `web_fetch` reliably available when the skill is selected.
**Architecture:** Initial skills are copied from the repository `skills/` directory into each instance workspace by `create-instance.sh` and `entrypoint.sh`. This change updates the seed catalog, not existing user workspace state.
**Tech Stack:** Python skill catalog storage, JSON seed metadata, Markdown `SKILL.md`, pytest.
---
### Task 1: Update Initial Skill Contract
**Files:**
- Modify: `app-instance/backend/tests/unit/test_initial_skill_tool_hints.py`
- [ ] **Step 1: Write the failing test**
Change `EXPECTED_INITIAL_SKILL_TOOLS` so it expects:
```python
"multi-search-engine": ["web_fetch"],
```
and no longer expects:
```python
"web-operation": ["web_fetch", "web_search"],
```
- [ ] **Step 2: Run test to verify it fails**
Run:
```bash
cd app-instance/backend
pytest tests/unit/test_initial_skill_tool_hints.py -q
```
Expected: FAIL because `skills/multi-search-engine/versions/v0001/SKILL.md` does not exist yet.
### Task 2: Replace Seed Skill
**Files:**
- Create: `skills/multi-search-engine/current.json`
- Create: `skills/multi-search-engine/skill.json`
- Create: `skills/multi-search-engine/versions/v0001/SKILL.md`
- Create: `skills/multi-search-engine/versions/v0001/version.json`
- Create: `skills/multi-search-engine/versions/v0001/CHANGELOG.md`
- Create: `skills/multi-search-engine/versions/v0001/CHANNELLOG.md`
- Create: `skills/multi-search-engine/versions/v0001/config.json`
- Create: `skills/multi-search-engine/versions/v0001/metadata.json`
- Create: `skills/multi-search-engine/versions/v0001/references/advanced-search.md`
- Create: `skills/multi-search-engine/versions/v0001/references/international-search.md`
- Modify: `skills/_index/published.json`
- [ ] **Step 1: Add SkillHub content**
Fetch `global/multi-search-engine@20260413.065325` from SkillHub and store it as seed version `v0001`.
- [ ] **Step 2: Add tool hint**
Ensure `SKILL.md` frontmatter contains:
```yaml
tools:
- web_fetch
```
- [ ] **Step 3: Update published index**
Remove `web-operation` and add `multi-search-engine`.
### Task 3: Verify
**Files:**
- Test: `app-instance/backend/tests/unit/test_initial_skill_tool_hints.py`
- [ ] **Step 1: Run targeted tests**
Run:
```bash
cd app-instance/backend
pytest tests/unit/test_initial_skill_tool_hints.py tests/unit/test_marketplace_and_mcp.py -q
```
Expected: PASS.
- [ ] **Step 2: Inspect seed metadata**
Run:
```bash
python - <<'PY'
import json
from pathlib import Path
print(json.loads(Path('skills/_index/published.json').read_text())['items'])
print(json.loads(Path('skills/multi-search-engine/versions/v0001/version.json').read_text())['tool_hints'])
PY
```
Expected: `multi-search-engine` is published, `web-operation` is absent, and tool hints are `["web_fetch"]`.