用途:Align 是智能体与人类之间的三阶段契约,由 prompt-align 承载。调用 /align <task> 即表示人类同意全部三个阶段。
主要能力:第一阶段 Align,智能体先读代码、配置和日志,找出真正会导致工作内容不同的分歧点,发布一个简报页,每个决策都是一句可编辑的句子,并附上备选(ghost)方案;第二阶段 Edit,人类挑选备选、直接改写,或用 // 注释引导 AI,发送简报后保存 result.json;第三阶段 Implement,保存的结果即持续授权,据此实施、验证并汇报到完成,不再重复询问是否继续。
使用方式:需要 Bun 和 prompt-align 检出。目录解析顺序为 $PROMPT_ALIGN_DIR、~/dev/prompt-align 或 ~/prompt-align,否则执行 git clone https://github.com/johnlindquist/prompt-align ~/prompt-align。CLI 以 bun <dir>/src/server.ts … 调用。简报含 jobId、title、seed、context 和 slots,槽位键为 reading、scope、proof、cadence,服务端强制 slug 键、名称不超过 24 字符、1-9 个备选且每个不超过 400 字符,最多 12 个槽位。第二阶段先确保服务运行,再 prompt-align push /path/to/job.json,把返回的 url 交给人类,并在结束回合前以后台任务执行 prompt-align wait <jobId> --timeout 4h。第三阶段从 <data-dir>/jobs/<jobId>/result.json(默认 ~/.prompt-align)继续,result.brief 即契约,sentences[].source 反映人类参与程度,steeringUsed 是人类的原话约束。
适用场景:需要在动手前明确任务理解、范围、完成标准和检查节奏的编码任务。
限制:服务仅绑定 127.0.0.1,URL 带 token,未经人类同意不得对外暴露;结果只授权所选工作的本地编辑与验证,不授权推送、部署或发布,除非句子明确说明;wait 超时(退出码 1)则不得实施任何内容,需报告页面 URL、jobId 和恢复命令 prompt-align wait <jobId> --timeout 4h;结果一旦存在即为最终,重跑需推送新的 jobId,提交重复需 ?replace=1。其他细节暂未提供。