modus 開發與寫作 是做什麼的？
這是一套服務於 Modus 框架自身 的複合技能。一個入口連接全域認知、模組開發、測試發布和文章寫作；模組指南按任務載入，不把整個參考目錄一次性塞進上下文。
先確定當前專案
原始碼位置以使用者指定的 checkout 為準；未指定時使用當前 Git 倉庫根目錄。本技能目錄由載入的 SKILL.md 所在位置確定。首次進入一個 checkout，將 SKILL_DIR 設為本技能目錄，在 Modus 倉庫根目錄運行唯讀診斷：
python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .
它檢查分支、HEAD、上游、本地修改、套件版本與知識基線漂移，不聯網、不寫倉庫、不呼叫已安裝的 Modus。使用任一 Python 3.11+ 直譯器，可按實際環境替換範例中的 python3.11。
知識快照來自 modus-open / 49c51621f378a58d6724eedde4657d9505346d45，分發套件 openmodus 0.0.4。不同分支、版本或檔案變化意味著相關指南需要回到當前實作核對；不要自動切分支、升級個人 CLI 或生成專案知識。
先讀 全域概覽，再按下表選擇指南。已熟悉專案且任務明確時，可直接進入相關模組。
任務路由
| 當前任務 | 讀取 |
|---|---|
| 功能開發、修正、重構、原始碼審查 | 開發流程 + 對應模組 + 驗證與發布 |
| 幫助、參數、退出碼、中文體驗、個人套件維護 | CLI 與維護入口 |
| 接入、升級、卸載、清單、資產衝突、Git 保護 | 專案安裝與所有權 |
| CodeBuddy / Claude / Cursor / Codex 接入、啟動鉤子 | 平台與鉤子 |
| 原始碼發現、凍結、解析、編譯器、語言擴展、快取命中 | N1–N2：原始碼與觀察 |
| 身份解析、呼叫關係、拓撲、入口到效果、能力遍歷 | N3–N4：解析與能力 |
| 範圍候選、聚類建議、證據包、上下文、游標、摘要 | N5–N6：投影與交付 |
| 當前專案上下文、知識路由、排名、原始碼回退、預算 | 檢索與編排 |
| Markdown 身份、CAS、知識更新、錨點、完整性與發布核驗 | 知識寫入與核驗 |
| init/reinit/update/sync 行為、產生正文、範圍確認、模板 | 知識創作工作流程 |
| 多倉工作區、成員定址、外部導航、隔離 | 工作區 |
| wheel、原始碼套件、依賴、CI、測試選擇 | 驗證與發布 |
| 文章、報告、技術介紹、分享大綱、架構圖 | 原始碼依據與寫作；涉及的機制聯讀對應模組 |
| 核對 iwiki、舊材料或本技能依據 | 來源與差異 |
最容易改錯的邊界
- Modus 安裝接入、初始化證據、長期 Markdown 知識有不同所有者。
modus init安裝資產；/modus-init由助手調查並創作知識。 - 普通檢索讀當前原始碼與正式 Markdown。初始化分析快取不成為日常運作的事實來源；新增能力不要把
machine匯入普通 CLI 路徑。 - N1–N6 是確定性證據處理，K1–K6 是助手的語義創作。能力組合不呼叫 LLM，候選與代表路徑不等於正式領域或完整運作鏈路。
- 安裝/更新交易與知識更新的失敗語義不同。知識更新按檔案提交並報告部分成功，不能承諾整批回滾。
.modus/和宿主副本是受管接入資產；modus/knowledge/是長期知識；人工constraint/、references/business/有獨立保護。clean只證明檢查器所覆蓋的完整性或發布承諾，不證明正文真實、完整、清晰，也不證明執行時成功。- 命令、JSON 欄位、狀態碼、穩定 ID 與中文展示分開維護。模板是隨套件交付的產品行為契約。
完成任務
開發結果說明具體行為、修改所有者、實際驗證和未驗證邊界。寫作結果把當前實作、設計目標、歷史材料和效果證據分開。引用本技能能加速定位，但實作結論必須回讀當前原始碼。
本技能支援後續開發，不授予發布、提交、推送、外部文件寫入或委派權限；這些動作沿用當前使用者任務的授權。不要因使用本技能自動重建知識、更新技能或改動無關資產。