規格 v0.1.0 · 開源

像管理團隊一樣管理 AI

你的管理經驗 — 範圍控制、審查流程、決策追蹤 — 編碼成 AI 能遵循的協議。

閱讀規格 → GitHub 原始碼
AI Worker 撰寫程式碼 生成 lock 人類審核 AI Reviewer 驗證
6 個欄位,6 個問題

產品邊界所需的一切

沒有路由、沒有框架、沒有相依性。只有產品本身。

actors

誰在使用?定義的是人,不是程式碼。

entities

儲存什麼資料?產品資料模型。

features

能做什麼?原子級產品能力。

stories

如何互動?產品敘事。

permissions

誰能做什麼?角色對功能矩陣。

denied

絕對不能有什麼?最重要的欄位。

範例

看起來是什麼樣子?

一個 JSON 檔案完整描述產品邊界。幾分鐘內即可閱讀。

{
  "name": "chat-system",
  "version": "1.0.0",
  "description": "Real-time chat with group conversations and read receipts",
  "author": "kim",

  "actors": ["Admin", "Guest", "Member"],

  "features": ["createGroup", "listConversations", "readReceipts", "sendMessage"],

  "denied": {
    "Reaction": "Keep messaging simple, no emoji reactions",
    "editMessage": "Messages are immutable once sent",
    "voiceCall": "Text-based communication only"
  }
}
信任模型

兩個互不信任的 AI

一個生成、一個驗證。人類做最終決定。

Human

掃描 lock,批准或否決。不需閱讀程式碼。幾分鐘讀完 lock。

AI Worker

撰寫程式碼,從程式碼庫生成 lock。提交審查。

AI Reviewer

獨立驗證程式碼與 lock 的一致性。不信任 Worker。

文件

你需要的一切

為人類和 AI 準備的指南。每份文件各司其職。

規格

Product Lock 規格書

完整規格。檔案格式、欄位定義、驗證規則、生命週期與慣例。

閱讀規格 →
指南

生成器指南

AI Worker 專用。10 步流程分析程式碼庫並生成 product.lock.json。

閱讀指南 →
指南

審查指南

AI Reviewer 專用。逐欄驗證流程。如何捕捉違規。

閱讀指南 →
規格

計畫規格

Lock 定義「什麼」。Plan 定義「如何」。實作藍圖格式。

閱讀規格 →
工具

評分系統

從 lock 量化產品複雜度。PLS 公式經 10 個開源產品驗證。

閱讀評分 →
工具

工作日誌

追蹤跨工作階段的變更、決策與範圍。為 AI 重建脈絡。

閱讀日誌 →