tabcode-operator
代码项目操作——读写编辑文件、搜索代码、诊断验证、 运行 lint、执行 Git 安全操作。用户提到"读文件""写代码""搜索代码""git""lint"时使用。
- License 许可
- AGPL-3.0
- 所属仓库
- tabtin-ai/TabTin
- 最近更新
- 2026-10-08
- Stars
- ★ 454
- Forks
- 115
01 前言 Front Matter
- name
- tabcode-operator
- metadata
- { "tabtin": { "tags": [ "code", "development", "file" ], "tools": [ "web_search", "run_terminal_command", "read_file", "write_file", "edit_file", "delete_file", "glob_search", "grep_search" ], "category": "developer", "displayName": "TabCode Operator", "autoActivateFor": [ "tabcode" ] }, "version": "0.3.1" }
- description
- 代码项目操作——读写编辑文件、搜索代码、诊断验证、 运行 lint、执行 Git 安全操作。用户提到"读文件""写代码""搜索代码""git""lint"时使用。
03 SKILL.md 正文
TabCode Operator
代码项目文件操作与搜索,直接调用对应工具——不要绕 tabtin code CLI 子命令。
操作方式
6 件套是 LLM 直接可见的 TabCode FC 工具,按需调用,参数即工具入参:
| 工具 | 用途 | 必填参数 | 常用选填 |
|---|---|---|---|
read_file |
读取文件(带行号) | path |
offset(起始行,1 起算,可负从尾部数)/ limit(最大行数) |
write_file |
写入或覆盖文件 | path, contents |
— |
edit_file |
精确字符串替换 | path, old_string, new_string |
replace_all(替换所有匹配) |
delete_file |
删除文件 | path |
— |
glob_search |
文件名模式搜索 | glob_pattern(如 **/*.tsx) |
target_directory |
grep_search |
代码内容正则搜索 | pattern |
path / glob / type / output_mode / -i / -A/-B/-C |
注意:
- 编辑前必须先
read_file读取目标文件——edit_file依赖最近一次读取的内容做匹配。 edit_file的old_string必须在文件中唯一;不唯一时多带几行上下文,或用replace_all。- 路径支持相对(相对于
workspace_root)和绝对。
建目录 / 移动 / 重命名(CLI-only,无 FC 工具)
创建目录、移动或重命名文件没有对应的 FC 工具(above 7 件套不含 mkdir/move),
走 run_terminal_command 调 CLI:
run_terminal_command(command="tabtin code mkdir --path src/newdir")
run_terminal_command(command="tabtin code mv --from src/old.go --to src/new.go")
run_terminal_command(command="tabtin code rename --from src/old.go --to src/new.go") # rename 是 mv 的别名
mkdir对齐mkdir -p:递归创建,目标已是目录时幂等成功,撞到同名文件时报错。mv/rename默认不覆盖已存在的目标路径(无--force);不允许把路径移动到自身子树内。
三层搜索策略
根据搜索意图选择合适工具,三者互补:
-
grep_search— 精确匹配,适合已知符号- 查找 class/function/variable 定义
- 支持正则表达式
-
glob_search— 文件名模式发现- 找到特定类型文件,了解目录结构
典型工作流:glob_search 发现文件 → grep_search 精确查找 → read_file 深入阅读
编辑约束
- 编辑前必须先
read_file读取文件 - 使用
edit_file做精确替换,避免重写整个文件 - 如果
old_string不唯一,提供更多上下文行使其唯一 - 代码注释应简洁——只在代码本身无法传达意图时添加
- 不要添加叙述性注释(如"导入模块"、"定义函数")
Git 操作规范
查看状态和变更
run_terminal_command(command="git status") # 分支、staged/unstaged 文件
run_terminal_command(command="git diff") # 未暂存的变更
run_terminal_command(command="git diff --staged") # 暂存区变更
修改操作
run_terminal_command(command="git add .")
run_terminal_command(command="git commit -m 'message'")
- 永远不要
git reset --hard(除非用户明确要求) - 永远不要
git push --force到 main/master - commit 前先用
git status和git diff查看变更 - 不要自动 amend 已推送到远程的 commit
- 不要跳过 pre-commit hooks
Web 信息检索
web_search— 搜索网络获取实时信息(FC 工具)tabtin fetch <url>— 抓取静态 URL 页面正文转 Markdown(轻量 HTTP + readability,CLI 首选); 已打开 tab / JS 动态页取正文走tabtin browser print --save <path>(缺省当前 tab;公开动态页加--url), 落盘后按需读文件;二进制资源下载走tabtin browser resource download --url <url>。- 典型工作流:
web_search找到链接 →run_terminal_command("tabtin fetch <url>")抓正文
诊断与验证
- 编辑后 runtime 会在下一轮被动注入 LSP / lint 诊断;不要主动调用已退役的诊断 FC 工具。
- 需要主动验证时,运行项目已有 lint / typecheck / test 命令,或让用户提供指定命令。
- 编辑代码后检查自己引入的 lint 错误,不修复预存的
- 运行相关测试验证改动正确性
长命令管理
通过 run_terminal_command 执行耗时命令时:
- 默认
wait_ms=60000,上限 300000;到期不会杀进程,而是返回status="running"+session_id+pid+output_file。 - dev server / watcher / 持续 log → 传
wait_ms: 0立即后台化。 - 任务完成时 push 通知会激活下一轮 turn——你可以继续做别的事不用主动等。
- 想看进度:
read_file(output_file)。 - 想停掉:用
run_terminal_command跑kill <pid>(pid 在 envelope 里返回;卡死进程用kill -9;模拟 Ctrl+C 用kill -INT)。
目录体系
| 标识 | 含义 |
|---|---|
code_project |
用户打开的代码仓库 |
agent_dir |
Agent 产出目录 |
user_folders |
用户文件夹 |
workspace_root 是文件工具和 terminal 的默认工作目录。
- 文件路径支持相对路径(相对于 workspace_root)和绝对路径
- 不要
cd到 workspace_root——它已是默认工作目录
效率规则
- 上下文已注入当前项目路径和 Git 状态 → 不要重复查询
- 独立的读操作可以并行执行(使用不同 session_id)
- 先理解代码结构再动手修改——探索 → 理解 → 修改 → 验证
04 同仓库更多 Skills
tabtracker
管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。
tabtin-project
在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。
skill-market
管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。
tabtin-widget
渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。
resource-link
插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。
mcp-operations
操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。