用途
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 中追加工作流路由说明,不覆盖已有内容。
使用方式
执行流程分为三个阶段:
- 只读发现:运行 git remote -v 解析仓库地址,运行脚本 dry-run 检查工具链和认证状态,检查现有文件,若全部已配置则直接报告并停止。
- 暂存与授权:以 Changeset 表格形式列出缺失或未配置的资产,等待人工批准,禁止未经授权写盘。
- 原子应用:批准后写入文件、应用 Git 配置并运行脚本更新环境文件。
适用场景
适合需要快速建立仓库级智能体工作流约定的项目,尤其是同时涉及 GitHub 或 GitLab 远程、需要统一任务跟踪与测试入口的团队。
限制
资料未提供具体安装步骤、依赖要求、支持的 Git 托管平台完整列表、脚本内部实现细节以及失败恢复策略,这些信息暂未提供。