ai-dev-workflow技能生成：WorkBuddy复杂功能描述

ai-dev-workflowSkillHubai-dev-workflowClawHubWorkBuddy复杂功能描述需求点0AI对话与智能执行功能点0.1自然语言对话与工具调用执行点0.1.1发送消息与智能响应用户操作在对话界面底部输入框输入自然语言消息。支持多种输入方式纯文本直接输入问题、指令或描述引用语法file://路径引用特定文件folder://路径引用整个目录skill://技能名直接加载技能附件上传拖拽文件到输入框粘贴截图CtrlV支持图片格式jpeg、png、gif、webp支持文档格式pdf、docx、xlsx、pptx、md、txt等点击发送按钮或按回车键提交。实时查看AI执行过程工具调用状态文件操作进度命令执行输出搜索结果展示获取最终响应结果可继续追问或切换话题。系统逻辑上下文组装读取身份文件SOUL.md角色定位、IDENTITY.md身份信息、USER.md用户画像读取工作记忆.workbuddy/memory/MEMORY.md长期记忆 今日/昨日日志加载项目上下文文件树快照、项目配置拼接历史对话当前会话的完整消息历史总Token数控制不超过128K意图识别与分类闲聊问答类直接生成回复代码生成类准备调用write_to_file/replace_in_file文件操作类准备调用read_file/search_file/list_dir搜索探索类准备调用search_content/code-explorer命令执行类准备调用execute_command技能触发类匹配已安装技能的triggers准备调用use_skill团队协作类准备调用task/send_message自动化任务类准备调用automation_update工具选择与执行基于意图自动选择合适的工具组合支持单次调用多个工具并行执行敏感操作触发确认流程删除文件delete_file执行命令execute_command修改系统配置操作工作区外文件失败时提供详细错误信息和修复建议响应生成流式返回响应内容逐字显示展示工具调用结果摘要提供后续操作建议自动判断是否需要调用open_result_view/preview_url展示结果关键配置参数最大上下文Token数128K流式响应默认开启工具调用并发限制5个并行敏感操作确认开关默认开启响应语言中文执行点0.1.2多模态输入处理用户操作图片输入截图后直接粘贴CtrlV拖拽图片文件到输入框点击附件按钮选择图片支持格式jpeg/jpg、png、gif、webp文件引用输入file:触发文件选择器从项目文件树中选择文件文件内容自动加载到上下文支持代码文件、Markdown、JSON、XML等目录引用输入folder:引用整个目录AI获取目录结构快照可浏览、搜索、分析目录内容技能加载输入skill://技能名直接加载技能示例skill://AI Dev Workflow加载编程工作流技能技能SKILL.md自动注入上下文添加说明文字可选“解释这张截图中的架构”“分析这个文件的代码逻辑”“使用这个技能生成项目”系统逻辑图片处理调用视觉模型分析图片内容支持能力OCR文字提取代码截图解析UI设计稿分析图表数据识别图片转Base64或上传临时存储最大尺寸2048x2048像素文件处理读取文件内容注入上下文大文件支持分段读取offset/limit自动检测文件编码UTF-8、GBK、GB2312显示行号便于讨论特定代码行目录处理获取目录结构快照list_dir支持glob模式筛选如**/*.kt自动忽略node_modules、.git、dist、build、pycache技能处理加载技能的SKILL.md到上下文加载references/目录下的参考文档注册scripts/目录下的可用脚本执行技能定义的工作流关键配置参数图片最大尺寸2048x2048图片最大文件大小10MB大文件分段大小每段1000行目录忽略模式node_modules、.git、dist、build、pycache、.next功能点0.2会话管理执行点0.2.1创建与管理会话用户操作创建新会话点击侧边栏新建对话按钮或使用快捷键CtrlN新会话自动关联当前工作区切换会话在会话列表中选择历史会话点击后恢复完整对话历史工作区上下文自动切换会话操作重命名右键点击选择重命名删除右键点击选择删除置顶右键点击选择置顶导出导出为Markdown文件会话搜索在搜索框输入关键词搜索范围会话标题、消息内容结果高亮显示匹配项系统逻辑会话创建生成唯一会话IDUUID创建今日工作记忆文件.workbuddy/memory/YYYY-MM-DD.md如不存在初始化空的消息历史列表设置会话关联的工作区路径会话恢复从SQLite数据库加载历史消息按时间顺序渲染到对话区域重新读取工作区上下文重新加载记忆文件会话持久化实时保存每条消息到数据库工作记忆自动追加到日志文件支持跨设备同步如启用云同步会话删除软删除会话记录保留日志用于审计保留关联的工作记忆文件30天后永久清除关键配置参数会话存储位置%APPDATA%/WorkBuddy/data/conversations.db历史消息保留策略永久软删除保留期30天会话标题自动生成基于首条消息内容需求点1文件系统操作功能点1.1文件读写与编辑执行点1.1.1读取文件用户操作直接请求“读取 config.json”“查看 src/main.kt 的内容”“打开 README.md”引用语法“file://src/utils/Helper.kt”搜索后读取先搜索文件列表选择要读取的文件分段读取大文件“读取 main.kt 的前100行”“查看 log.txt 的最后50行”“读取第200到300行”系统逻辑路径解析相对路径基于当前工作区根目录绝对路径直接使用需在工作区内或获批准路径规范化处理..、.、分隔符差异编码安全防止路径遍历攻击文件读取调用read_file工具自动检测文件编码UTF-8、GBK、GB2312、ISO-8859-1添加行号标记格式1:代码内容大文件支持offset/limit分页读取图片文件直接渲染展示内容展示Markdown渲染代码块语法高亮根据文件扩展名显示文件元信息大小、行数、编码IDE诊断信息错误、警告、提示如可用错误处理文件不存在提示并建议相似文件权限不足提示并引导授权编码错误尝试多种编码解码安全规则仅允许读取工作区内文件敏感文件读取警告.env、credentials、private_key、secrets工作区外文件需用户确认关键配置参数默认读取行数限制无限制但Token受限分段读取默认大小1000行支持的图片格式jpeg、png、gif、webp执行点1.1.2编辑文件用户操作描述修改意图“把 main.kt 中的 fun 改成 suspend fun”“在 config.json 添加一个新字段”“删除 utils.kt 中的第10到15行”AI展示修改计划显示待替换的原始内容显示替换后的新内容高亮差异部分确认执行查看修改内容后确认或提出调整意见查看修改结果文件修改后自动重新读取显示修改后的内容调用linter检查语法错误系统逻辑内容定位先读取当前文件完整内容根据用户描述定位待修改位置提取精确的字符串片段old_str验证匹配唯一性old_str在文件中只出现一次替换执行调用replace_in_file工具精确字符串替换保留原始缩进空格/Tab保留原始换行符CRLF/LF保留原始引号中文/英文、单/双引号失败时提供详细错误old_str未找到old_str出现多次文件被外部修改变更验证重新读取文件确认修改成功调用read_lints检查语法错误显示修改前后对比提供撤销建议如使用Git状态规则文件被锁定其他进程写入中等待或提示文件不存在提示创建新文件文件为空直接使用write_to_file关键配置参数自动linter检查默认开启显示修改对比默认开启执行点1.1.3创建与删除文件用户操作创建文件“创建 src/api/UserApi.kt”“新建 README.md 并写入以下内容…”“创建目录 src/utils/”删除文件“删除 temp.txt”“删除 dist 目录”确认删除操作敏感操作批量操作“创建以下文件a.kt, b.kt, c.kt”“清空 build 目录”系统逻辑文件创建调用write_to_file工具自动创建父目录如不存在文件存在时覆盖提供警告设置创建时间戳目录创建使用execute_command执行mkdir -p或New-Item -ItemType Directory递归创建父目录文件删除调用delete_file工具Windows移动到回收站macOS移动到废纸篓Linux使用gio trash或trash-put记录删除日志时间、路径、原因批量操作单次最多处理10个文件每个文件操作后验证成功任一失败立即停止并回滚安全规则禁止删除.workbuddy目录禁止删除系统目录/、C:\、/System、AppData、Library、~/.config禁止递归删除Desktop、Downloads、Documents、Home目录工作区外文件操作需用户确认批量删除需额外确认关键配置参数批量操作最大文件数10个删除方式回收站/废纸篓不直接rm功能点1.2文件搜索与探索执行点1.2.1搜索文件用户操作按文件名搜索“搜索所有 .kt 文件”“找 test_*.py”“搜索包含 ‘service’ 的文件”按内容搜索“搜索包含 ‘TODO’ 的文件”“查找 ‘fun main’ 函数定义”“搜索所有 ‘import kotlinx’ 的行”支持正则表达式组合搜索“在 .kt 文件中搜索 ‘class User’”“搜索 test 目录下的所有 TODO”系统逻辑文件名搜索调用search_file工具支持glob模式*任意字符、?单字符、**递归递归搜索子目录自动排除node_modules、.git、dist、build、pycache返回相对路径列表内容搜索调用search_content工具基于ripgrep支持正则表达式支持文件类型过滤--type js、--type py支持glob过滤--glob *.kt显示匹配行及上下文支持显示匹配文件列表、匹配计数结果展示文件路径可点击跳转匹配行号匹配内容高亮显示上下文行前后各3行性能优化大项目使用code-explorer子代理结果分页显示每页100条支持搜索结果导出关键配置参数默认忽略目录node_modules、.git、dist、build、pycache、.next、target搜索结果限制100条可分页上下文行数前后各3行正则模式超时5秒执行点1.2.2浏览目录结构用户操作列出目录内容“列出 src 目录内容”“查看项目根目录”“显示 api 文件夹下的所有文件”查看项目结构“展示项目文件树”“查看目录层级结构”过滤目录内容“列出所有 .kt 文件”“只显示目录不显示文件”系统逻辑目录浏览调用list_dir工具显示文件和子目录显示文件大小、修改时间不显示隐藏文件以.开头结构展示树形结构显示层级缩进文件类型图标目录统计文件数、总大小忽略模式支持glob模式忽略特定文件默认忽略.git、node_modules等关键配置参数默认显示隐藏文件否最大递归深度无限制但Token受限忽略模式可通过ignore_globs参数指定需求点2技能系统功能点2.1技能发现与安装执行点2.1.1浏览与搜索技能用户操作打开技能中心点击侧边栏专家入口或点击技能中心按钮浏览技能市场分类浏览编程、写作、数据分析、自动化等热门推荐最新更新搜索技能输入关键词搜索按标签筛选按评分/下载量排序查看技能详情点击技能卡片查看功能描述查看使用示例查看评分评价查看版本历史系统逻辑技能列表加载从ClawHub API获取技能列表或扫描本地技能仓库缓存列表提升加载速度分类筛选按标签分类按评分排序高到低按下载量排序按更新时间排序技能详情加载技能的SKILL.md渲染Markdown为HTML解析元数据name、author、description、version执行点2.1.2安装与卸载技能用户操作安装技能在技能详情页点击安装按钮或从本地文件夹导入“从 ~/.skills/my-skill 安装技能”等待下载和安全检查安装成功提示查看已安装技能在已安装标签页查看查看技能版本、大小、安装时间卸载技能点击卸载按钮确认卸载操作技能文件被删除系统逻辑技能下载从ClawHub下载技能包或从本地路径复制解压到~/.workbuddy/skills/{skill_name}/保留文件结构SKILL.md、references/、scripts/安全检查调用use_skill加载 skills-security-check 技能扫描SKILL.md和所有脚本文件检测危险模式危险命令rm -rf、sudo、mkfs、dd if代码注入eval()、exec()、subprocess.call(shellTrue)网络请求检查是否连接未知服务器风险评级P0严重强烈警告建议不安装P1警告警告用户需确认P2安全通过检查可安装向用户展示审计报告技能注册将技能信息写入本地数据库更新可用技能列表解析triggers触发条件卸载清理删除技能目录清理数据库注册信息保留用户数据如有安全规则P0风险强烈建议不安装需用户明确确认P1风险警告用户需确认P2风险直接安装不执行技能中的自动运行脚本关键配置参数技能安装路径~/.workbuddy/skills/安全检查开关默认开启技能格式要求必须包含SKILL.md功能点2.2技能使用与开发执行点2.2.1使用技能用户操作自动触发输入匹配技能triggers的消息示例输入创建PPT自动加载pptx技能系统自动加载技能并执行手动触发skill://技能名语法从技能列表点击使用按钮示例skill://AI Dev Workflow按技能指引交互技能加载后按SKILL.md定义的流程执行可能需要用户提供额外信息可能有中间确认步骤查看技能输出技能执行结果展示生成的文件、报告等系统逻辑技能加载调用use_skill工具读取 SKILL.md 内容注入上下文加载 references/ 目录下的参考文档注册 scripts/ 目录下的脚本为可用资源技能执行遵循 SKILL.md 定义的工作流步骤可调用内置工具read_file、write_to_file等可调用外部脚本支持与用户交互确认技能输出生成文件代码、文档、报告执行操作创建项目、运行命令提供建议架构方案、优化建议执行点2.2.2开发新技能用户操作启动技能创建向导“创建一个新技能”或skill://skill-creator填写技能信息技能名称技能描述触发条件作者信息编写SKILL.md定义工作流步骤编写详细指令添加示例添加参考资源可选在 references/ 目录添加参考文档在 scripts/ 目录添加Python脚本测试技能本地加载测试修复问题迭代优化发布技能填写版本号semver格式1.0.0填写变更日志上传到ClawHub技能市场系统逻辑技能脚手架调用 skill-creator 技能生成标准目录结构my-skill/ ├── SKILL.md ├── references/ └── scripts/创建 SKILL.md 模板技能验证检查 SKILL.md 格式验证必需字段name、description测试脚本可执行性技能发布打包技能文件上传到 ClawHub生成技能详情页等待审核如需要需求点3命令执行与系统集成功能点3.1命令行执行执行点3.1.1执行系统命令用户操作请求执行命令“运行 npm install”“执行 pytest tests/”“启动开发服务器 npm run dev”“编译项目 ./gradlew build”查看命令输出实时显示stdout输出实时显示stderr错误显示退出码处理交互自动响应提示--yes、-y、--no-interaction或等待用户输入长时间运行命令后台执行可查看实时日志可手动终止系统逻辑命令构建根据操作系统选择shellWindowsPowerShellmacOS/LinuxBash处理路径转义空格、特殊字符拼接命令参数设置工作目录为当前项目根命令执行调用execute_command工具继承环境变量可设置额外环境变量设置超时时间输出处理流式返回输出实时显示区分stdout和stderr解析退出码0成功非0失败禁用分页git --no-pager、| cat安全控制敏感命令需确认删除rm、del、rmdir、shutil.rmtree系统配置sudo、chmod、chown网络curl、wget上传数据时格式化mkfs、format禁止危险命令组合rm -rf /、sudo rm -rf超时自动终止安全规则工作区外命令需确认敏感命令需确认禁止执行的命令递归删除系统目录格式化磁盘修改系统配置无明确确认网络上传数据到未知服务器关键配置参数命令超时时间300秒5分钟敏感命令列表rm、del、sudo、chmod、mkfs、format自动响应提示–yes、-y、–no-interaction功能点3.2运行时管理执行点3.2.1管理编程语言运行时用户操作查看可用运行时“检查Python版本”“查看Node版本”“列出所有可用运行时”安装特定版本“安装 Python 3.12”“安装 Node 20”“安装 Python 3.10”切换运行时自动检测项目需求自动选择满足要求的版本或手动指定版本系统逻辑运行时检测扫描系统已安装的运行时扫描隔离安装的运行时~/.workbuddy/binaries/检查版本兼容性缓存检测结果运行时安装调用install_binary工具从官方发行版下载安装到隔离目录Python~/.workbuddy/binaries/python/versions/3.12.0/Node~/.workbuddy/binaries/node/versions/20.0.0/创建虚拟环境环境隔离Python创建venvpython -m venv ~/.workbuddy/binaries/python/envs/default安装包到venvvenv/bin/pip install pkg运行脚本venv/bin/python script.pyNode使用项目级node_modules不全局安装避免污染系统不污染用户系统环境关键配置参数运行时安装路径~/.workbuddy/binaries/虚拟环境路径~/.workbuddy/binaries/python/envs/Python版本3.13.12已安装Node版本可通过install_binary安装需求点4团队协作功能点4.1多代理协作执行点4.1.1创建团队与分配任务用户操作创建团队“创建一个开发团队”定义团队名称如feature-team定义团队目标如开发用户模块添加团队成员指定成员角色前端开发后端开发测试工程师代码审查员设置权限模式acceptEdits自动接受文件编辑bypassPermissions跳过所有确认default正常确认流程plan先规划后执行分配任务向特定成员发送任务任务描述清晰具体成员并行工作协调沟通成员间通过消息通信共享工作进展汇报完成状态关闭团队任务完成后删除团队清理团队资源系统逻辑团队创建调用team_create工具创建团队目录.workbuddy/teams/{team_name}/初始化团队配置文件设置团队目标成员创建调用task工具创建子代理指定subagent_namecode-explorer等指定name成员名称指定mode权限模式指定team_name所属团队成员异步执行后台运行消息通信调用send_message工具支持消息类型message私信broadcast广播shutdown_request关闭请求shutdown_response关闭响应plan_approval_response计划审批消息投递到成员邮箱成员下次turn时处理消息任务协调跟踪成员状态收集结成果处理关闭请求汇总团队输出团队清理调用team_delete工具停止所有成员邮箱轮询保存最终历史删除团队目录关键配置参数团队目录.workbuddy/teams/最大成员数10个消息投递实时成员下次turn时处理子代理类型code-explorer需求点5自动化系统功能点5.1定时任务与触发器执行点5.1.1创建自动化任务用户操作打开自动化管理查看现有自动化列表查看上次/下次执行时间查看执行状态创建新自动化点击新建自动化按钮或请求创建“每天早上9点提醒我查看邮件”“每小时检查一次构建状态”“每周一生成周报”配置触发条件定时触发每小时FREQHOURLY;INTERVAL1每2小时FREQHOURLY;INTERVAL2每天9点FREQDAILY;BYHOUR9;BYMINUTE0每周一9点FREQWEEKLY;BYDAYMO;BYHOUR9;BYMINUTE0工作日FREQWEEKLY;BYDAYMO,TU,WE,TH,FR一次性触发指定具体日期时间2026-04-10T14:30有效期validFrom任务开始生效日期validUntil任务失效日期编写任务指令描述要执行的任务任务自包含无需用户交互示例“检查今日待办任务并发送提醒”“运行测试并报告结果”“拉取最新代码并构建”配置执行参数指定工作区路径设置最大执行时长设置状态ACTIVE 或 PAUSED保存并启用系统逻辑自动化注册调用automation_update工具生成自动化ID写入配置文件.workbuddy/automations/{id}/automation.toml注册到SQLite调度表计算下次执行时间调度执行定时检查触发条件每分钟到期时启动后台会话执行任务指令记录执行日志更新上次执行时间计算下次执行时间状态管理ACTIVE正常执行PAUSED暂停执行执行中避免重复执行超时自动终止失败处理记录错误日志可配置重试次数发送失败通知关键配置参数自动化存储路径~/.workbuddy/automations/调度检查间隔每分钟最大执行时长30分钟可配置失败重试次数0次默认不重试时区用户本地时区需求点6记忆系统功能点6.1工作记忆执行点6.1.1记忆读写与蒸馏用户操作自动记忆完成重要工作后AI自动追加日志示例创建/修改文件修复bug生成报告选择技术方案用户无需手动操作手动记忆“记住我喜欢用Kotlin”“记录这个项目使用MVVM架构”“记住我的代码风格偏好”查看记忆“查看我的工作记忆”“我之前做过什么”“回忆一下上次的决策”更新记忆“更新记忆改用Python”“删除过时的记忆”系统逻辑日志写入追加到.workbuddy/memory/YYYY-MM-DD.md记录内容完成的工作关键决策代码变更摘要用户告知的偏好格式Markdown追加式不覆盖长期记忆更新更新.workbuddy/memory/MEMORY.md存储内容项目约定架构模式、技术栈个人偏好语言风格、命名规范稳定的跨会话事实更新式覆盖旧值注明变更原因和日期记忆读取会话开始时自动加载MEMORY.md长期记忆今日日志YYYY-MM-DD.md昨日日志注入到上下文用户询问时检索相关记忆记忆蒸馏每次会话开始时检查超过30天的日志需要蒸馏提取关键信息到MEMORY.md删除旧日志文件保持记忆简洁关键配置参数记忆目录.workbuddy/memory/日志文件格式YYYY-MM-DD.md长期记忆文件MEMORY.md日志保留天数30天蒸馏触发条件每次会话开始需求点7结果展示与交付功能点7.1结果呈现执行点7.1.1展示工作成果用户操作自动展示任务完成后AI自动判断结果类型选择合适的展示方式自动打开结果视图手动请求展示“展示生成的HTML”“打开报告文件”“预览网页”下载交付物点击下载按钮打包多个文件选择保存位置系统逻辑结果检测判断产出文件类型HTML使用preview_url报告/文档使用open_result_view图片直接渲染代码代码块展示选择展示方式预览渲染HTML文件调用preview_url工具在内置浏览器打开支持热重载开发服务器文档文件调用open_result_view工具在Artifact视图展示支持Markdown渲染图片文件read_file直接渲染支持缩放代码文件代码块展示语法高亮可复制文件交付调用deliver_attachments工具按重要性排序打包相关文件提供下载链接关键配置参数Artifact目录%APPDATA%/WorkBuddy/brain/{conversation-id}/支持的预览格式HTML浏览器预览PDF/DOCX/PPTX/XLSXArtifact视图图片直接渲染Markdown渲染展示需求点8知识库检索功能点8.1RAG知识检索执行点8.1.1查询知识库用户操作自动检索根据对话上下文自动判断是否需要检索AI自动调用RAG_search手动触发“查询微信小程序开发文档”“搜索腾讯云API使用方法”“查一下TDesign组件库”系统逻辑知识库匹配根据查询意图匹配知识库可同时查询多个知识库检索执行调用RAG_search工具传入查询字符串指定知识库名称结果整合返回相关文档片段注入上下文生成基于知识库的回答可用知识库腾讯云API微信云开发腾讯云实时音视频TDesign微信支付微信小程序微信小游戏腾讯地图小程序工作流总览需求点功能点核心能力关键工具0. AI对话与智能执行自然语言对话、多模态输入、会话管理上下文组装、意图识别、工具选择、流式响应read_file、write_to_file、execute_command1. 文件系统操作文件读写编辑、搜索探索精确替换、内容搜索、目录浏览read_file、replace_in_file、search_file、search_content2. 技能系统技能发现安装、技能使用开发ClawHub集成、安全审计、工作流执行use_skill、skill-creator3. 命令执行与系统集成命令行执行、运行时管理Shell命令、环境隔离、版本管理execute_command、install_binary4. 团队协作多代理协作团队创建、成员分配、消息通信team_create、task、send_message5. 自动化系统定时任务与触发器Cron调度、后台执行、状态管理automation_update6. 记忆系统工作记忆日志写入、长期记忆、蒸馏清理replace_in_file追加日志7. 结果展示与交付结果呈现HTML预览、文档展示、文件交付preview_url、open_result_view、deliver_attachments8. 知识库检索RAG知识检索知识库匹配、文档检索、结果整合RAG_search