用途:把一个空仓库或已有仓库改造成可使用 agentic-workflow 的项目,先复制通用脚手架,再按项目实际情况定制,而不是保留原始占位符。适合需要将文档基座(AGENTS.md 加 docs/ 地图加模板)适配到具体项目、而非直接静态复制的场景;若只想拿原始脚手架自行填写,应改用静态复制命令 npx degit gtrabanco/agentic-workflow/template。
主要能力:先勘察目标目录,识别是否已有 agent 指南、docs/ 与 .github/,并从清单文件(package.json、pyproject.toml、go.mod、Cargo.toml、Gemfile 等)探测技术栈,据此提议门禁命令与命名约定,同时记录 git 状态与远端平台。区分启动与升级两条互斥路线:全新或外来仓库走 bootstrap 发现与写入;已是本工作流脚手架则走仅追加的 upgrade。写入适配后的 AGENTS.md、docs/ 脚手架与 .github/ 模板,种子 docs/workflow/REPOSITORY_STATE.md,可选提供架构不变量文档,并写入自适应泳道约定(单元文档、分诊、证据行、进度日志、提交格式等)。
使用方式与限制:所有安装、钩子、覆盖均需明确同意;不得在没有许可时覆盖已有 agent 指南或 docs/。检索索引脚手架与 git 钩子需就“是否安装文档检索索引脚手架及其 git 钩子”明确回答是后才安装,否则记录为残留项,之后再次访问也需重新获得同意。仅做文档脚手架,不写应用代码、不擅自安装依赖。对已有仓库不在默认分支上工作,未要求不提交推送。占位符宁可如实保留并标注待填,也不应编造具体细节。具体命令与模板细节以官方文档为准,部分内容暂未提供。