1.1.1
ait plan
記錄帶版本的 Markdown 沿革,並在設定的範圍內同步確切的 sprint 條目。
適用對象: coding agent 與維護者
角色#
通常由 coding agent 執行,作用範圍嚴格照儲存庫生成的指示裡列印的 那一個來。
用途#
ait plan 記錄帶版本的 Markdown 沿革。在 sprint 模式下,某一個確切 的未勾選清單項會成為 Task 的繫結物件;普通文件同步一下就好,不必開 成 Task。
語法#
ait plan sync <markdown-file-or-dir> --local
ait plan sync <markdown-file-or-dir> --remote origin只用與目前生效的儲存庫設定相符的那個範圍。首次執行的 ait task start --from 負責同步它所繫結的那個 sprint 條目的確切 檔案。
示例#
# Password Visibility [plan-ref: login/password-visibility/root]
- [ ] Add the accessible control and focused tests. [ref: login/password-visibility/implement]ait plan sync docs/architecture.md --local輸出#
同步會報出 Plan 的標識、修訂、執行的動作和發布範圍。Plan 的檢視類 命令只讀取條目和修訂,不會改動它們。
失敗與恢復#
不要把 Plan ID 複製到 task start 裡,也不要把 Markdown 核取方塊的 改動藏進程式碼 Snapshot。遠端收尾把清單項的更新單獨留出來時,直接改 那個繫結的確切條目,再在設定好的遠端範圍裡同步這張 card。