comment-authoring-discipline 是做什麼的？
在實作過程中與最終審查（final-review、multi-review 或 architecture-review）前，對程式碼註解進行品質評估。此標準同樣適用於 Codex、Claude 和 OMP，涵蓋 Python、Kotlin、React Web、React Native、iOS、Swift 與 SwiftUI 等多種語言與框架。
在實作過程中與最終審查前，對程式碼註解進行品質評估，適用於 Codex、Claude 和 OMP 等多種平台及程式語言。
這項技能旨在協助開發者在程式碼撰寫與審查過程中，確保註解的品質與一致性。透過在實作階段與最終審查（如 final-review、multi-review 或 architecture-review）前分別執行註解品質檢查，能有效提升程式碼的可讀性與可維護性。該技能支援 Codex、Claude 和 OMP 等主流 AI 開發輔助平台，並涵蓋 Python、Kotlin、React Web、React Native、iOS、Swift 與 SwiftUI 等多種程式語言與框架。使用者只需遵循技能提供的註解品質標準，即可在開發流程中自動化或手動檢查註解，避免過時、冗餘或不明確的註解產生。
npx skills add https://github.com/chonamdoo/agent-flow/tree/main/skills/comment-authoring-discipline在實作過程中與最終審查（final-review、multi-review 或 architecture-review）前，對程式碼註解進行品質評估。此標準同樣適用於 Codex、Claude 和 OMP，涵蓋 Python、Kotlin、React Web、React Native、iOS、Swift 與 SwiftUI 等多種語言與框架。
This repo contains 5 individual skills — each has its own dedicated page.
Common code generation and code modification discipline for agent-flow. Use before and during implementation, TDD red/green/refactor, fix-loop, bug fixes, feature work, and any task where Codex, Claude, OMP, or another agent writes or changes code. Enforces start-before, during-implementation, and after-implementation checks without a scoring rubric.
Flutter implementation and review checklist. Use only when writing, modifying, or reviewing Flutter widget code, layout constraints, adaptive sizing, navigation and routing, platform channels, platform views, background entry points, list and image performance, async gaps across `BuildContext`, disposal, theme and design tokens, accessibility, localization, offline and error states, or Flutter test and golden coverage. Do not use for Dart language generalities, native Android or iOS internals beyond the engine and channel-registration seam a Dart entry point depends on, or broad rewrites.
Use when implementing or reviewing iOS app-wide error handling where SwiftUI views/ViewModels notify common errors and an @main App, WindowGroup AppShell, NavigationStack coordinator, or UIKit AppCoordinator owns root navigation, tab/session flow switching, alerts, sheets, toast hosts, SessionExpired handling, Maintenance handling, and root reset behavior.
Use when creating, modifying, or reviewing an iOS Clean Architecture presentation layer with SwiftUI/UIKit state holders, explicit UiState, UiModel mapping, dependency injection, and state-based presentation code review.
Synthesizes the current conversation and codebase context into a PRD, then writes or publishes it according to the caller's requested output target. Use when the user asks to turn an already-discussed idea, plan, or conversation into a PRD; use `grilling` first if key decisions are still unresolved.
ElevenLabs text-to-speech with mac-style say UX.
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
Capture and automate macOS UI with the Peekaboo CLI.
Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".