AGENT SKILL

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);不允许把路径移动到自身子树内。

三层搜索策略

根据搜索意图选择合适工具,三者互补:

  1. grep_search — 精确匹配,适合已知符号

    • 查找 class/function/variable 定义
    • 支持正则表达式
  2. 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

tabtin-ai
tabtin-ai/TabTin

tabtracker

管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-project

在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

skill-market

管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。

★ 454
tabtin-ai
tabtin-ai/TabTin

tabtin-widget

渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。

★ 454
tabtin-ai
tabtin-ai/TabTin

resource-link

插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。

★ 454
tabtin-ai
tabtin-ai/TabTin

mcp-operations

操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。

★ 454