Skip to content

About

Open-source AI Skill for building traceable, company-specific accounting systems. Created by Tim Chen.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Open Accounting System Builder

繁體中文 | English

驗證狀態 授權條款

一個開源的 AI Skill,透過漸進式訪談協助公司負責人理解產業與商業模式背後的會計邏輯、查核所在地適用的現行規範,並建立公司專屬、可追溯、可對帳、可交接的內部會計制度。

由 Tim Chen 建立及維護。

本專案協助整理會計事實、內部控制、作業流程與專業覆核問題,不構成會計、記帳、稅務、法律、審計、簽證或申報意見。

為什麼需要這個專案?

許多剛成立或正在成長的公司,會先從一張混合用途的試算表開始:收款、支出、股東匯款、信用卡與備忘事項全放在一起;憑證散落各處,規則只存在某個人的記憶裡。

這個 Skill 讓 AI 不只是「幫忙分類交易」,而是先理解公司怎麼營運,再協助建立一套能持續使用的會計制度。它不會把某一家公司的做法假設成所有公司的答案。

專案採兩層架構:

  1. 共享的開源 Skill:保存訪談、研究、制度設計、驗證與更新方法。
  2. 每家公司獨立的 Company Accounting Pack:保存該公司的事實、政策、科目、交易、待辦與專業覆核結果。

公司名稱、交易、帳號、客戶、員工與憑證等敏感資料,應留在私密的 Company Accounting Pack,不應提交到這個公開 Repo。

主要功能

  • 首次啟動就先顯示老闆看得懂的功能清單,而不是先問會計科目。
  • AI 依已知情況預選建議;老闆可直接「照建議」、一次多選/取消,或新增自訂功能。
  • AI 推薦與老闆正式確認會分開記錄;功能可後續新增、停用、改優先順序並保留版本。
  • 功能可客製,但來源追溯、查重、借貸平衡、對帳、寫入前預覽與專業邊界等安全控制不能被關閉。
  • 每輪只詢問少量、真正會影響制度設計的決策點。
  • 先用白話拆解收款、履約、收入、成本、退款與平台撥款,再討論科目與分錄。
  • 將結論區分為 FACT、AI_PROPOSAL、OFFICIAL_SOURCE、OPEN_QUESTION 與 PROFESSIONAL_DECISION_REQUIRED。
  • 依公司的交易量、複雜度與管理需求,建議使用試算表、會計軟體或混合流程。
  • 建立政策、科目表、交易收件匣、複式分錄、憑證索引、對帳、未決事項、月結與版本控制模板。
  • 在寫入公司資料前要求明確的資料範圍、儲存位置與持久化授權。
  • 驗證資料結構、必填欄位、重複鍵、借貸平衡、訪談關卡與正式入帳準備狀態。
  • 讓法定財報、稅務調整與管理分析都能追溯到單一正式帳務來源。
  • 從單一、狀態為 POSTED 的複式分錄生成同口徑的權責損益與老闆首屏,不用第二套未受控的帳重算。
  • 當 O6 啟用時,再讓老闆複選首屏、損益、成本、資料信心、月結與自訂管理報表。

用 Codex 自動安裝

把下面這段提示交給 Codex:

請使用 $skill-installer,從 GitHub 安裝以下公開 Skill:

Repository:ChristimCiel/open-accounting-system-builder
Path:skills/company-accounting-system-builder
Ref:v1.4.0

安裝前請先檢查 SKILL.md 與 scripts。
如果同名 Skill 已存在,請停止並告訴我,不要直接覆蓋。
安裝完成後請告訴我;我會在下一輪開始使用。

安裝完成後,在下一輪輸入:

請使用 $company-accounting-system-builder。

先不要直接替我入帳。請先給我 AI 預選的多選功能清單,讓我可以直接照建議、一次增減多個項目,或新增自訂功能。收到我的確認後,再逐步訪談我並依已選功能建立:

1. 產業會計地圖
2. 適用會計與財務架構
3. 現況診斷
4. 最適合的帳務系統
5. 公司專屬 Company Accounting Pack

所有涉及收入認列、稅務、股東交易、跨境、薪資或法定申報的事項,都要標示是否需要會計師、記帳士、稅務或法律專業人士覆核。

Codex 的 Skill Installer 會把 Skill 放進使用者的 Skills 目錄。其他 AI 產品即使可以讀取公開 Repo,也不一定具備安裝或持久保存本機 Skill 的能力。

手動安裝

只需要把下面的資料夾複製到 Codex Skills 目錄:

skills/company-accounting-system-builder

安裝後的資料夾名稱必須保持為:

company-accounting-system-builder

如果安裝後沒有立即出現,請重新載入或重新啟動 AI 工作環境。

第一次使用會發生什麼?

Skill 的第一個實質問題一定是「你想讓這套系統做什麼」。它會先顯示 8 個白話結果,並根據目前已知內容預選建議:

  • 看懂產業的錢怎麼跑
  • 檢查現在的帳哪裡有洞
  • 建立公司自己的內帳制度
  • 搬舊帳與清理歷史資料
  • 日常記帳、憑證、待收與待付
  • 對帳、月結、現金與獲利報表
  • 記帳士/會計師覆核與交接
  • 匯入、串接、週期作業與安全匯出

你可以回覆「照建議」、「加 O3/O6、移除 O1」,或「自訂:我要看每個門市的獲利」。未收到明確選擇前,Skill 不會開始研究、讀敏感資料或建立檔案。

之後隨時輸入「修改功能」,就能新增、停用、排序或修改自訂功能;Skill 只顯示差異,老闆確認後才生效。

完成功能多選後,才進入漸進式訪談:

  1. 確認功能優先順序、公司所在地、組織型態、營運階段、資料範圍與儲存位置。
  2. 理解產品/服務、付款、履約、退款、平台、直接成本與管理需求。
  3. 建立產業會計地圖並請公司負責人確認。
  4. 查核所在地當期適用的官方規範、準則版本與生效日。
  5. 診斷現況並建議正式帳務來源。
  6. 建立公司專屬政策、科目、憑證、分錄、對帳與月結流程。
  7. 使用代表性交易試跑,確認後才允許正式寫入。

涉及稅務、收入認列、股東/關係人、跨境、薪資、存貨、固定資產或其他高判斷事項時,Skill 會整理成專業覆核問題,不會自行宣稱已符合法規或準則。

v1.4 圖表化管理報表

v1.4 將「帳務來源」與「報表呈現」分開。標準結構的權責損益草案、老闆首屏與 Excel 原生圖表,都必須從同一份 POSTED journal 生成;管理維度、分攤或重分類只能作為可追溯的管理調整,不能回頭改寫正式分錄。

使用者仍是先複選 O1–O8;只有老闆確認 O6 後,Skill 才展開下列可再複選的報表子功能:

  • dashboard:老闆首屏,優先回答本月賺賠、可用現金、錢卡在哪裡與今天要做什麼。
  • profit:權責損益、每 100 元收入留下多少,以及與上期或目標的差異。
  • cost:直接成本、營運費用、主要變動與產品/專案/通路觀點。
  • trust:資料截止日、對帳狀態、暫估、缺憑證、衝突與待專業覆核影響。
  • close:月結進度、阻擋項目、負責人與下一步。
  • custom:老闆自訂門市、專案、產品或其他管理視角,由 AI 先提案,確認後才啟用。

老闆還會另外看到圖表多選:

  • 帳載權責 vs. 管理口徑損益柱狀圖。
  • 收入、成本、費用與淨利的正負影響柱狀圖。
  • 前六大成本水平長條圖。
  • 成本構成甜甜圈圖:僅在所有成本非負、總額大於零且至少兩類時可啟用。
  • 啟用維度後的產品、專案、門市或通路獲利柱狀圖。

如果執行環境可建立並驗證試算表,主要交付為 management-dashboard.xlsx,含 Dashboard、P&L、Cost Analysis、Dimension Profit、Chart Data、Data & Lineage 與 Checks;圖表從可見公式區取數,匯出後會重新匯入檢查原生圖表與公式錯誤。無試算表能力時,才降級為 Markdown/JSON。

儀表板必須把「本月淨利/淨損」與「現金增減/可用現金」分開呈現,不得暗示賺錢就等於已收到現金。這些都是可追溯的內部管理輸出;除非已有適切專業人士對明確範圍與日期的書面結論,不得宣稱為法定財報、已符合會計準則、已經專業覆核或可直接申報。

Repo 結構

skills/company-accounting-system-builder/
├── SKILL.md
├── agents/openai.yaml
├── assets/templates/
├── references/
└── scripts/

Repo 根目錄只保存專案說明、授權、驗證、版本與貢獻文件,不包含任何真實公司的帳本。

驗證專案

在 Repo 根目錄執行:

python3 scripts/validate_repository.py

建立 Company Accounting Pack 並執行 onboarding 檢查:

python3 skills/company-accounting-system-builder/scripts/init_company_pack.py \
  /path/to/private/accounting-system \
  --authorization-reference "conversation:explicit-user-authorization" \
  --authorized-by "company-owner"

python3 skills/company-accounting-system-builder/scripts/validate_company_pack.py \
  /path/to/private/accounting-system \
  --stage onboarding

驗證通過只代表對應的結構與機械性控制通過,不代表會計、稅務、法律、審計或申報正確。

隱私與安全

不要把生成後的 Company Accounting Pack 或任何真實會計憑證提交到這個 Repo。回報漏洞或疑似資料外洩前,請先閱讀 SECURITY.md。

參與貢獻

歡迎提出 Issue 與 Pull Request。請先閱讀 CONTRIBUTING.md,所有案例都必須使用合成或完整去識別化資料。

品牌與作者標示

Open Accounting System Builder 是專案名稱;Skill 的穩定技術 ID 是 company-accounting-system-builder。

本專案採 Apache-2.0 授權,允許使用、修改及散布。授權不代表 Tim Chen 為修改版本背書,也不授權他人用專案名稱包裝實質上不同的產品。詳見 NOTICE 與 LICENSE。

引用方式:

Open Accounting System Builder, created by Tim Chen
https://github.com/ChristimCiel/open-accounting-system-builder

授權條款

Apache License 2.0。詳見 LICENSE 與 NOTICE。

About

Open-source AI Skill for building traceable, company-specific accounting systems. Created by Tim Chen.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages