agentic-workflow

面向 GitCode 托管项目的 AI 交付编排与 CodeArts 流水线迁移工具。项目将 GitCode CLI 的 Issue、PR、Actions、Release 能力组合为可审计的交付闭环，并提供确定性的 CodeArts JSON → .gitcode/workflows/*.yml 转换器。

当前能力

• doctor：检查 Node.js、GitCode CLI、认证和本地仓库环境。
• migrate codearts：转换 pipeline detail JSON；可合并 CloudBuild job config；输出 workflow 与诊断报告。
• delivery inspect：读取 Issue、关联 PR 和 Actions runs，计算交付阶段及下一动作。
• Claude Code plugin marketplace：提供端到端交付和流水线迁移技能。
• Codex 原生 plugin marketplace：通过 .codex-plugin/plugin.json 分发相同的交付与迁移 Skills。
• OpenCode npm plugin：提供交付检查、迁移和环境诊断工具。

完整设计见 整体架构、方案设计 和 插件发布方案。

安装与使用

要求 Node.js 20+、GitCode CLI 0.12.0+，并完成 gitcode auth login。

npm install
node src/cli.js doctor --json

迁移 CodeArts 流水线：

node src/cli.js migrate codearts \
  --input pipeline.json \
  --job-config-dir job-configs \
  --output .gitcode/workflows/ci.yml \
  --report doc/migration-report.md \
  --strict --json

检查交付状态：

node src/cli.js delivery inspect --repo owner/repo --issue 123 --json

安装 Codex 原生插件：

codex plugin marketplace add https://gitcode.com/gitcode-cli/agentic-workflow.git
codex plugin add agentic-workflow@personal

仓库开发态可将第一条命令的 URL 替换为本仓库绝对路径。安装后，Codex 会发现 gitcode-agentic-delivery 和 migrate-codearts-pipeline 两个 Skills；确定性命令仍由 npm CLI 提供。

开发验证

npm test
npm run check
gitcode precommit check --run --yes --json

--strict 在存在 blocker 时返回退出码 4。静态转换无 blocker 不代表迁移完成；workflow 仍须经过 GitCode 平台校验、影子运行和行为对比。

提交门禁参考 GitCode CLI 仓库：pre-commit 阶段执行格式/语法、私钥、AWS 凭证、大文件、Node 语法和 gitleaks 工作区扫描；pre-push 额外执行单元测试、生产依赖审计和 Git 历史 secret 扫描。gitleaks 必须在 PATH 中。