ait-native

1.2.0 · 開發中 · 尚未發布

1.2.0 開發指南

準備儲存庫、了解審查與復原，並在發布前規劃遷移。

1.2.0 · 開發中 · 尚未發布

本草稿說明 1.2.0 開發契約，不代表已有公開套件、下載、管道或完成的資格驗證。穩定版安裝仍為 1.1.4；僅原始碼具備的行為需要已準備好的現行開發版執行檔。

搜尋本開發草稿

開發版快速上手

先備妥開發版執行檔。下列是語法參考，不是 1.2.0 安裝步驟。使用開發命令前，確認執行檔身分與 help；只有版本字串不足以證明其原始碼功能。

ait --version
ait init --help
ait team contacts --help

在要修改的儲存庫初始化，查看回傳的啟動準備狀態，並閱讀產生的 AGENTS.md：

cd <your-repository>
ait init
ait team contacts --json

首次 init 啟用 Teams，並嘗試準備 PM Newton。仍需要支援的 agent 主機及回傳的啟用步驟。既有儲存庫 init 保留 Teams 設定；明確開關與等待設定的處理方式見上方參考。

向 coding agent 說明結果、限制與驗收條件。準備 session 不會開始工作；PM 另行指派範圍、sprint 卡與獨立 Reviewer。遵循產生的儲存庫流程；首次建置、測試或擷取 Snapshot 前，先在回傳的 Task edit root 檢查 .aitignore。AIT 不會匯入 .gitignore。

就緒、審查與收尾

Local 與 Remote 是不同操作範圍，Teams 與 sprint 綁定都不會選定範圍。sprint-on 儲存庫以卡上的確切開放項目啟動 Task，同步卡片並取得 edit root：

ait task start --from docs/sprints/example.md#example/item --intent "Implement the agreed result" --local

卡片與確切項目必須已存在。只在回傳的 edit root 工作，執行適用檢查，再凍結 Snapshot 交獨立 Reviewer。初始工作不需要 Change。Local 收尾由 Reviewer 在乾淨工作區執行 ait task finish <TASK_ID> --local；未擷取的改動需要 --message "<message>"。原生命令成功才證明套用、完成、清理與確切綁定項目的自動結案。

Remote 準備中，<REMOTE> 是指定遠端名稱，<TASK_ID> 是所屬 Task。下列僅示範語法，不是對本網站草稿執行的命令：

ait workflow ready <TASK_ID> --remote <REMOTE>
ait workflow ready <TASK_ID> --apply --remote <REMOTE>
ait workflow finish <TASK_ID> --apply --remote <REMOTE>

沒有 --apply 的 ready 只檢查就緒狀態；明確 apply 才準備候選內容並推進實際 CI。保留回傳的 Repository、套件 hash/Job 與 base/final Snapshot 身分；正式候選使用確切 Patchset 身分。不可從套件回應臆造正式 Patchset。守門 finish 前仍須通過真實 CI、必要的獨立程式碼審查、Task 核准與強制 Policy。由指定 Reviewer 收尾；手動 --tests pass 不會提供 CI 證據。即使 exit zero，pending/stopped 也不代表完成。

恢復執行與 Server 重啟

情況必要行為
只有 CLI 結束，Server 執行仍有效沿用原候選、Job、模式與身分。現行預設改變不會重新定義已封存候選。
正式接受前實際重啟 Server先復原既有原生交易以確認提交或回滾。使未完成執行失效、停止舊 Runner/下載使用，只清理已無使用者的自有 CI 資源，否則回報待清理。保留唯一可用的封存來源。
已接納的原始 pin 重新準備透過既有 ready apply 與原始完整 --expected-identity <path>／操作脈絡重新準備。驗證回傳的新 Job、相同封存內容/base/revision 與原模式。重新執行真實 CI 與必要獨立審查及治理。拒絕過期身分、租約與結果，不可沿用已失效核准。
正式接受已提交，但回應遺失核對相符的原接受結果，再重試未完成收尾。保留原 ID、接受與一次套用，不新增 Job、CI、審查或重複套用。

未固定身分的全新 ready 無法保證舊封存內容。唯讀狀態與 finish 不會執行重設或重新準備。未知、缺漏或矛盾證據必須停止復原。實際的正式化前 Server 重設不保證同 Job 持續；只有 CLI 重啟是另一種情況。這些是必要契約，不代表整合重啟或平台驗證已通過。

退役與遷移

規劃中的公開 1.2.0 家族排除聊天整合執行檔 ait-agent 與 ait-agent-worker。保留原始碼、測試、授權與歷史，Agent Teams 及核心 Python/Node bindings 仍受支援。保留的舊聊天 binding 介面以既有錯誤管道明確回報退役，不提供可運作的聊天功能。

升級前檢查實際舊套件的檔案清冊，由原管道的原生套件管理負責升級／移除。已檢查的 1.1.4 Homebrew、APT、WinGet 擁有 ait、ait-server、ait-runner；PyPI 擁有 CLI/server/binding，npm 擁有 command/binding。歷史原始碼元件列表不證明該管道安裝過退役聊天檔案。

只有確實屬於套件的退役檔案，才可依該管道既有擁有權規則移除。保留設定與使用者資料。GitHub 壓縮檔與手動安裝沒有可授權任意刪除的套件收據：保留其檔案，並區分命令來源與所選新候選。不可依檔名直接刪除或掃蕩 PATH。並排壓縮檔檢查不能證明原生套件升級覆蓋。

發布說明草稿 · 1.2.0 尚未發布

以上是開發變更與要求。必要的 Community/安全、原生六平台、語言、並行 agent、安裝升級、binding 與發布管道驗證，仍需實際候選綁定結果。此輪延後 Personal 專屬協定、現行／舊版相容與 UI 驗收，不代表公開支援 Personal。1.1.4 舊結果與封存手冊僅證明原始位元組，不代表 1.2.0 已驗證、發布或切換 stable/latest。

權威與版本邊界

本機草稿依據 Core 已審查的 Agent Teams、init、config、Task 與 workflow 參考，以及 Native 現行 distribution 與 release SOP。這些開發變更尚非已發布手冊。定版的 1.1.4 發布來源僅支持穩定版基準；封存技術手冊與 PDF 保留原版本及證據。