用途:zenforge-init 是仓库脚手架引擎,为代码仓库补齐任务追踪、测试锚点、Git 隐私、文档索引与智能体宪法挂钩,避免覆盖已有的有效配置。
主要能力:按远端与认证状态选择任务追踪方式:GitHub 远端且 gh auth status 有效时,可建议 GitHub Issues(使用 references/issue-tracker-github.md 模板)或本地 Markdown;GitLab 远端且 glab auth status 有效时,可建议 GitLab Issues(使用 references/issue-tracker-gitlab.md 模板)或本地 Markdown;未认证 CLI、其他远端或离线时建议本地 Markdown(.agents/tasks/,模板 references/issue-tracker-local.md),并向用户报告 CLI 认证状态。测试锚点使用 references/harness-anchor.md 模板,扫描 test/AGENTS.md、tests/AGENTS.md、docs/**/testing*.md、<subsystem>/test/AGENTS.md 等既有测试指南作为 SSOT 路径记录,不转录内容;扫描 test/helpers/、test/fixtures/ 登记已有基础辅助函数。隐私方面始终在 .gitignore 隔离 .agents/scratch/,本地 Markdown 时默认 .agents/tasks/ 仅本地。文档索引在 docs/README.md 建立 Placement Matrix。宪法挂钩优先写入 CLAUDE.md,否则写入或创建 AGENTS.md,且只追加不覆盖。
使用方式:分三阶段。阶段一只读发现,运行 git remote -v,检测 gh auth status 或 glab auth status,检查 AGENTS.md 与 CLAUDE.md、.gitignore、.agents/task-tracker.md、.agents/harness-anchor.md、.agents/tasks/ 以及 docs/README.md 或 README.md;若全部有效则报告已初始化并立即停止。阶段二以 Changeset 格式列出缺失资产并暂停等待人工批准,禁止在聊天中输出原始文件内容。阶段三在获得批准后写盘并报告结果。后续可按需调用 /clarify、/harness-audit、/ssot。
适用场景:新仓库初始化,或为已有仓库补充任务追踪、测试治理、文档索引与智能体工作流约定。
限制:改动前必须经人工批准,不得覆盖有效配置,不得提交临时 scratch 文件;未认证或离线时只能使用本地 Markdown 追踪;资料未提供具体安装命令、支持平台与版本要求。