Loop Engineering 把基于 GitHub Issue、Project、PR 与 CI 的持续交付方法封装为一个原子化 plugin,同时支持 Codex 与 Claude Code。两个宿主加载同一组 skill 和同一份 Plan 合同,不再 维护或手工复制平行版本。
plugin 按顺序提供四个可组合 skill:
- loop-starter:确定范围、
governance档位与 Plan 级目标证据层级。 - loop-planner:形成可由人类批准的 Loop Execution Plan v2 机器可读合同。
- loop-executor:按获批 Plan 实现、 复查、等待 CI、交付并在 merge 后 closeout。
- loop-retrospective:基于真实 Issue、PR、CI 与 Project 证据复盘周期、质量和治理规则。
合同格式的唯一真值是 plan-contract-v2.md。
codex plugin marketplace add Moshuiwang/loop-engineering
codex plugin add loop-engineering@loop-engineering升级已安装版本:
codex plugin marketplace upgrade loop-engineering
codex plugin add loop-engineering@loop-engineering个人跨项目使用:
claude plugin marketplace add Moshuiwang/loop-engineering
claude plugin install loop-engineering@loop-engineering --scope user需要把启用声明提交到某个业务仓库时,改用 --scope project。升级已安装版本:
claude plugin marketplace update loop-engineering
claude plugin update loop-engineering@loop-engineering安装或升级后开启新会话再使用。不要把本仓库的 skill 手工复制到 ~/.codex/skills、
~/.claude/skills 或业务仓库;plugin cache 是可再生安装产物,不是编辑入口。
Codex 使用 $loop-engineering:loop-starter、$loop-engineering:loop-planner、
$loop-engineering:loop-executor、$loop-engineering:loop-retrospective 显式调用;Claude Code
使用对应的 /loop-engineering:loop-starter 等命名空间命令。
只在本仓库的 plugins/loop-engineering/skills/ 修改技能。四个 skill 作为一个 suite 随 plugin
版本原子发布;合同或治理语义变化必须同时检查四个 skill,不能只更新单个宿主副本。
python3 scripts/validate_distribution.py
python3 -m unittest discover -s tests -v
claude plugin validate --strict plugins/loop-engineering
claude plugin validate --strict .本仓库 CI 运行不依赖本机 Codex/Claude 安装的结构、版本、路径与合同一致性检查;宿主 CLI validator 与 Codex 内建的 skill/plugin validator 仍应在发布前本地执行。
- 只适用于某个业务仓库的命令、验收或授权规则,修改该仓库的
AGENTS.md/CLAUDE.md。 - 通用 loop 工作流、合同或宿主兼容问题,在本仓库创建 Issue 并通过分支与 PR 修复。
- 紧急试验使用本仓库分支和本地 marketplace;不直接修改用户 skill 目录或 plugin cache。
- 修复时记录宿主、plugin 版本、触发步骤、预期/实际和脱敏证据,并把真实故障转成回归检查。
- GitHub
Moshuiwang/loop-engineering是唯一可写源码权威;main保存已接受现状,PR 只保存 候选变更,tag/Release 标识可安装版本。 - GitLab 历史 remote 只用于归档或只读追溯,不接受新提交,也不反向覆盖 GitHub。
- 目标业务仓库的
AGENTS.md/CLAUDE.md、Project README 定义项目边界。 - Plan Issue 的
loop-planYAML 保存批准队列、依赖、授权、governance与完成条件。 - GitHub Project 是唯一 Status 真值;Git、PR、CI 与结构化评论保存实施证据。
- 不建立平行 Markdown 进度表。批准只能来自会话内人类的明确指示。