SuperAPI AI 工具集

solopowers-commit-scratchpad

办公与效率

查看项目

更新于 10-16 08:45

技能介绍

用途:把通常存放在仓库之外的 SoloTerm 便签(specs、plans、reviews、notes)在用户明确要求时写入 Git 工作树并提交。开始时应声明正在使用该技能持久化便签。

适用触发:用户说“commit this scratchpad”“save the plan/spec to the repo”“turn that scratchpad into a docs file”“publish the scratchpad content”等。正常头脑风暴或写计划不适用,除非用户另有要求。

前置条件:确认 SoloTerm MCP 服务器可访问且可读取便签;识别要提交的便签(用户指定则读该便签,说“当前这个”则用最近相关便签,不明确则先询问);除非用户已给路径,否则确认目标路径。

默认路径:名为 solopowers/specs/ 前缀的写到 docs/solopowers/specs/<name>.md;solopowers/plans/ 写到 docs/solopowers/plans/<name>.md;其他写到 docs/solopowers/scratchpads/<name>.md。名称需转为安全小写 slug,除非用户要求编辑,否则原样保留 Markdown 内容。

流程:读取便签内容(名称/ID、可能存在的修订号、完整 Markdown);检查敏感数据(密钥、令牌、个人数据、仅内部笔记),发现风险即停止并询问;选择目标路径;预览移交(便签名称/ID、目标路径、新建还是覆盖);写文件并按需创建父目录;用 git diff -- <path> 验证仅目标文件变动;为文档创建聚焦提交;报告目标路径与提交 SHA。提交信息应具体,如 git commit -m "docs: add <topic> plan",优先 docs: add <topic> spec、docs: add <topic> plan、docs: update <topic> notes,避免 update docs 或 commit scratchpad 等含糊信息。

红线:便签含密钥、凭据、私有 URL 或敏感个人数据;目标文件会被覆盖且用户未明确同意;可能有多个便签匹配;git diff 显示无关改动;仓库项目说明禁止提交文档产物——以上情况先停止并询问。