用途：这是 gh-aw（GitHub Agentic Workflows CLI）项目的开发者参考，用于统一代码组织、验证、安全与实现模式。
主要能力与内容：
- 操作命令手册：分层验证流程。每次重要编辑后运行 make build && make fmt；中间 report_progress 前运行 make agent-report-progress-no-test；最终 report_progress 前运行 make agent-report-progress；时间允许时运行 make agent-finish。test-unit 仅在最终阶段运行，预期最长 120 秒，超时可用 make test-impacted-go。变更类型对应命令：Go 文件用 make fmt，工作流 Markdown 用 make recompile，JavaScript（*.cjs）用 make fmt-cjs && make lint-cjs。合并 main 时运行 make merge-main，解决冲突后依次 make build、make recompile、git commit、make fmt。
- 大小写规范：产品名 GitHub Agentic Workflows 首字母大写，泛指 agentic workflows 小写，由 cmd/gh-aw/capitalization_test.go 自动测试强制。
- 代码组织：按功能而非类型分文件，单文件建议 100-500 行；创建类操作一文件一实体（如 create_issue.go），引擎分离（copilot_engine.go、claude_engine.go、codex_engine.go、custom_engine.go、engine_helpers.go），测试与实现同目录。避免 god 文件、模糊命名（utils.go、helpers.go）、混合关注点。
- 辅助文件约定：仅当 3 个以上文件共用、领域清晰且稳定时创建，如 github_cli.go、config_helpers.go、map_helpers.go、mcp_renderer.go。
- 字符串处理：sanitize 用于字符有效性（SanitizeName、SanitizeWorkflowName、SanitizeIdentifier），normalize 用于格式标准化（normalizeWorkflowName、normalizeSafeOutputIdentifier），避免重复处理。
适用场景：参与 gh-aw 仓库开发、重构与提交变更的开发者。
限制：资料未提供安装方式、收费、平台支持及完整安全与发布管理细节，暂未提供。