aibdd-activity-granularity-rule-docs

star 68

撰寫或審閱 Activity 顆粒度專用之規則 Markdown(Actor/Step):僅收容可判定的不變式條列、可選反例與預期對照,禁止混入 SOP 動作或 Upstream 追溯。於新建或修整 `**/rules/*granularity*.md`、被要求「顆粒度只留規則」、拆分規則檔與執行程序、或複寫 discovery 類顆粒度說明時使用。

Waterball-Software-Academy By Waterball-Software-Academy schedule Updated 5/29/2026

name: aibdd-activity-granularity-rule-docs description: 撰寫或審閱 Activity 顆粒度專用之規則 Markdown(Actor/Step):僅收容可判定的不變式條列、可選反例與預期對照,禁止混入 SOP 動作或 Upstream 追溯。於新建或修整 **/rules/*granularity*.md、被要求「顆粒度只留規則」、拆分規則檔與執行程序、或複寫 discovery 類顆粒度說明時使用。

AIBDD 流程顆粒度規則檔撰寫

Scope

適用標的為 只做顆粒度裁決 的短文(例:Actor 顆粒度、Step/Action 顆粒度)。承接整份 reasoning、顶替 SOP。

必遵守(核心規範)

  1. 顆粒度=規則的集合:正文以 宣言式規則(可對照/可否定)為主;不得在同檔混入執行程序(例如 READ、WRITE、DERIVE、LOAD、委派、步驟編號、見 SOP 第 N 步)。
  2. 區分責任:載入順序、授權寫入範圍、phase/sub-SOP 只寫進 SOP;規則檔 只回答「可否/必須/禁止」長相。
  3. 禁止附載:Upstream SSOT 路徑表、正式 skill 唯一權威聲明、與其它檔案的長篇對齊敘事、 obligating 跑腳本或掃仓库。
  4. 可選 # 反例:每条反例對應具體違規形狀(與上方某一條或數條規則對齊),用說明性語句即可,写成待執行 checklist。
  5. 反例可帶合規對照:若單一反例需收斂讀者理解,可在同一條末尾續寫 預期應⋯(合規長相一句話說清),另立「正例」章節若會與規則重複堆疊;避免在規則檔內再寫第二套教學流程。

編排慣例

  • 標題(顆粒度主題)→ 規則(條列)→ 若有需要再 # 反例
  • 規則用 得/不得/僅當 等可判定語氣;避免「建議先讀 X」類程序句。

與套件的接線

若外層 SOP 需要執行者在某步 READ 本規則檔,把 READ 指令寫在 SOP不要寫進規則檔內文。

Install via CLI
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill aibdd-activity-granularity-rule-docs
Repository Details
star Stars 68
call_split Forks 11
navigation Branch main
article Path SKILL.md
More from Creator
Waterball-Software-Academy
Waterball-Software-Academy Explore all skills →