principles: 前端人類友善/Arcrun AI 友善,都從終點看(leo 2026-07-21)

判準=AI 覺得 Arcrun 比 Python 簡單,沒有寫 Python 的慾望,絕不可迷路。
使用方式應意圖驅動:不用想有哪些零件,描述目的→機器給建議→用 >> 黏起來。
實證:總管做「定期打 API 然後通知」(Python 10 行)Arcrun 40 分鐘未完成,
全程被 component guide/publish_component 建議推向鑄零件。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-21 13:00:15 +08:00
parent 5edb97c49d
commit 98d87d5d3f
+1
View File
@@ -24,3 +24,4 @@
- **任何 code 變動前先讀對應 SDD 並宣告**:找不到對應 SDD → 停手問 richblack,不自行新建。
- **每完成一個 task 立刻更新 tasks.md `[x]`**,不批次。
- **缺能力的自力救濟階梯**:自家 API 缺→補 API;第三方 API 缺→workflow/code-node 補丁(非建零件);純計算→code-node;真需新穩定能力才零件 PR。
- **前端要人類友善,Arcrun 要 AI 友善——兩者都從終點看**(leo 2026-07-21):前端=讓人或 AI **輕易拿到查詢結果**Arcrun=**讓 AI 輕易建立程式碼**。驗收判準=「**AI 覺得 Arcrun 比 Python 還簡單,因此沒有寫 Python 的慾望**;至少可忍受、跟 Python 同級,**絕不可迷路、搞不懂**」。使用方式應為**意圖驅動**:使用者不用想有哪些零件,只描述「想達成什麼目的的過程」→ **機器給零件/recipe/workflow 建議** → 用 `>>` 把建議黏起來。**設計入口時問「這是為造零件的人設計,還是為有意圖的人設計?」**——前者會把使用者推向最難的路(實證:2026-07-21 總管做「定期打 API 然後通知」,Python 10 行,Arcrun 花 40 分鐘未完成,全程被 component guidepublish_component 建議推向鑄零件)。