SuperAPI AI 工具集

working-with-ssf

通用与其它

查看项目

更新于 10-16 06:48

技能介绍

用途:帮助某人安装、配置、运行、排查、升级或停止 Simple Software Factory(ssf),并按需编写或审查 SSF.md、配置驱动工厂的助手。ssf 把指派给机器人账号的 GitHub issue 和 pull request 变成编码代理会话,每个条目不一份,各自独立的 git worktree 与终端(herdr 下,另有不处理条目的 scratch 会话);人在条目评论中与代理协作,客户端可在本地、VM 或经 SSH 配置和查看工厂守护进程。支持 Linux 与 macOS。

用法:先确认 ssf 是否在 PATH。在则运行 ssf skill 得到按用户请求分类的路由,或用 ssf skill <topic> 查看对应主题(setup、repo、operate、config、harnesses、troubleshoot、ssf-md、audit、liaison、specifics)。不在则读 docs/install.md(raw 地址为 https://raw.githubusercontent.com/mikekelly/simple-software-factory/master/docs/install.md),其开头为资源检查,与用户共同决定采用本地 VM、专用服务器 host 模式、共享服务器上的 guest 还是本机 host 模式,然后走到第一个 issue。若是 ssf 自己启动的代理会话(SSF_SESSION 已设置),改读 ssf guide。安装本技能的命令为:npx skills add mikekelly/simple-software-factory -g,去掉 -g 为单项目安装,加 --skill working-with-ssf -y 跳过提示。

变更前先运行 ssf server list,再对目标运行 ssf --server NAME doctor 和 ssf --server NAME status。创建账号、花钱、选择模型与投入、允许他人驱动工厂或传 --force 前,须在需要该决定的步骤逐个征得同意;sudo 命令交给用户执行;机器人凭据只属于机器人。升级宿主上的 ssf 不会升级或重启 VM 的 guest,需用 ssf --server NAME vm upgrade [VERSION](或 --deb PATH)。VM 有独立生命周期,重启或停止 ssf@NAME 服务不会停 VM,需 ssf vm stop|restart 和 ssf ui service disable。ssf vm build --force 与 ssf vm reset 会丢弃 guest root 中的内容,不能用于升级。host 模式工厂的代理运行在自己的 herdr 会话 ssf 中,由守护进程启动;若被其他方式启动,先 herdr session stop ssf 再让守护进程重启。

限制与报错:向 upstream issue board 报告问题前须搜索已有 issue、先征求同意并展示草稿;报告应包含现象、最小复现步骤、预期与实际(含确切错误文本)、ssf 版本(ssf --version)、操作系统与所用 harness,并去除主机名、IP、账号、路径、仓库或组织名、令牌、密钥等敏感信息,用 HOST、REPO 等占位符替代。