SuperAPI AI 工具集

zenforge-init

部署与运维

查看项目

更新于 11-05 16:18

技能介绍

用途

zenforge-init 是 venhdev/zenforge 提供的仓库脚手架初始化工具,用于在项目中一次性建立若干基础配置文件,使后续智能体或开发者能按统一约定工作。它主要处理任务跟踪、测试锚点、开发环境说明、Git 隐私、文档索引和智能体公约六类资产。

主要能力

  • 任务跟踪:根据远程仓库和 CLI 认证状态,建议使用 GitHub Issues、GitLab Issues 或本地 Markdown 任务目录。
  • 测试锚点:生成 .agents/harness-anchor.md,扫描已有测试指南作为 SSOT 路径,并登记已有测试辅助函数。
  • 环境规格:通过 scripts/discover-toolchain.sh 发现运行时包装器、测试/分析命令和已安装 CLI,写入或更新 .agents/environment.md。
  • Git 隐私:确保 .agents/scratch/ 进入 .gitignore,并可选将 .agents/tasks/ 设为本地忽略。
  • Git 安全配置:设置 merge.conflictstyle、diff.algorithm、push.useForceIfIncludes、rebase.autoStash 等本地配置。
  • 文档索引:创建 docs/README.md 作为文档放置矩阵。
  • 智能体公约:在 CLAUDE.md 或 AGENTS.md 中追加工作流路由说明,不覆盖已有内容。

使用方式

执行流程分为三个阶段:

  1. 只读发现:运行 git remote -v 解析仓库地址,运行脚本 dry-run 检查工具链和认证状态,检查现有文件,若全部已配置则直接报告并停止。
  2. 暂存与授权:以 Changeset 表格形式列出缺失或未配置的资产,等待人工批准,禁止未经授权写盘。
  3. 原子应用:批准后写入文件、应用 Git 配置并运行脚本更新环境文件。

适用场景

适合需要快速建立仓库级智能体工作流约定的项目,尤其是同时涉及 GitHub 或 GitLab 远程、需要统一任务跟踪与测试入口的团队。

限制

资料未提供具体安装步骤、依赖要求、支持的 Git 托管平台完整列表、脚本内部实现细节以及失败恢复策略,这些信息暂未提供。