CCDawn Codex Skills

让 Codex 先理解你，再决定怎么做。

30 个中文优先 Agent Skills，支持 Codex 与 Grok Build，覆盖意图对齐、动态路由、多会话平级协作与自动闭环、轻量开发、代码结构守卫、性能工程、开发清理、代码审查、UI 设计和 AI 研究工作流。

用户正常说需求即可，不需要主动输入 /brt 或记忆流程命令。
ccdawn-brt 会在意图明确时直接推进，在高影响歧义出现时集中讨论并给出推荐。
简单任务直接实现和验证；只有真实风险存在时才升级到规划、内嵌任务图或紧凑 TDD。

English | 简体中文

20 秒看懂 BRT

BRT 从意图对齐到自动路由、实施与验证的演示

这是一个流程示例：用户只需正常表达需求；BRT 会先查证可用上下文，只讨论会改变结果的问题，然后把已对齐的任务交给最具体的 Skill。

快速体验

先预览最重要的入口 Skill：

gh skill preview CCDawn/codex-skills ccdawn-brt

使用 Agent Skills CLI 查看或安装：

npx skills add CCDawn/codex-skills --list
npx skills add CCDawn/codex-skills --skill '*' -g -a codex -y

这会安装 skill 文件，但不会修改全局 AGENTS.md。需要“正常说需求即可自动进入 BRT”的默认激活能力时，使用下面的仓库安装器。

需要 CCDawn 完整安装策略，包括安装演练、live copy 验证和可逆处理冲突入口时，使用仓库安装器：

git clone https://github.com/CCDawn/codex-skills.git
Set-Location codex-skills
powershell -ExecutionPolicy Bypass -File .\install.ps1

只安装到 Grok Build，或同时维护 Codex 与 Grok：

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Agent grok
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Agent codex-grok

macOS/Linux：

git clone https://github.com/CCDawn/codex-skills.git
cd codex-skills
sh ./install.sh

默认只安装到 ~/.codex/skills/<ccdawn-skill-name>，不会同时写入 ~/.agents/skills 造成重复入口。选择 grok 时安装到 ~/.grok/skills；选择 codex-grok 时只维护这两个运行时。安装器会在对应的 AGENTS.md 中维护可逆的轻量 BRT 激活块，让用户无需输入 /brt，并保留已有全局规则。高级选项见安装细节。

为什么使用 CCDawn

常见问题	CCDawn 的处理方式
用户没有写完整规格	先读取可查证上下文，再讨论真正会改变结果的问题
Skill 很多但不会自动选	BRT 选择最具体 owner，并可动态组合多个意图
已安装 GitHub、浏览器、Figma 或文档工具却不会用	BRT 按当前可用能力直接路由，CCDawn owner 只保留目标与验收
简单修改被流程拖慢	按子任务风险控制重量，默认优先直接实现和验证
新功能可能引入低效代码	普通功能静默检查明显低效；只有真实热路径或指标问题才测量和优化
开发不断堆出巨型单文件	对本轮手写源码使用 `STAY/CHECK/SPLIT`；只有职责边界可分时才做最小拆分
审查只给结论、不继续推进	形成按依赖排序的行动队列，在边界内连续处理
多个 Codex 会话同时开发	BRT 对齐后发现可互助的平级会话，让各自完成任务并协商共享边界与集成
多会话冲突后链路容易停住	用户确认一次后，自动协作闭环可接管失活协调、恢复暂停任务并验证合入本地 `main`
功能完成后残留临时文件和旧分支	仅在已知产生残留或用户要求时清理有归属证据的本地资源
AI 研究和普通开发混用流程	分离研究实验、评分循环、严谨性审查和软件 TDD

精选 Skill

ccdawn-brt：默认适配层，负责意图理解、讨论式对齐、路由和流程重量控制。
ccdawn-autonomous-collaboration-loop：用户确认一次后，持续驱动现有会话完成各自任务、恢复冲突并验证合入本地 main。
ccdawn-multi-agent-orchestration：连接同项目现有平级会话，让各 Agent 保留原任务，通过低噪声协商减少重复、冲突和集成返工。
ccdawn-thread-coordination：共享同项目 Agent 进度，协调冲突、讨论、暂停恢复与快速合并。
ccdawn-development-cleanup：清理开发残留，并安全收尾已合并本地分支、worktree 和 claim。
ccdawn-bug-review：从症状和失败证据定位根因，完成有界修复与验证。
ccdawn-performance-engineering：只在性能目标、回归或关键热路径需要测量时定位瓶颈并验证最小优化。
ccdawn-code-structure-guard：在开发中识别多职责巨型文件，只在维护收益明确时执行最小拆分。
ccdawn-pr-review：按风险排序审查 PR、diff、分支和合并准备度。
ccdawn-ui-design：处理 UI/UX、响应式、无障碍和浏览器视觉验证。
ccdawn-visual-design：建立符合产品语境的品牌表达、视觉方向和可实施界面语言。
ccdawn-ui-review：使用用户任务和浏览器证据审查已有界面，并输出按影响排序的 findings。
ccdawn-design-system：治理跨组件 token、主题、variants、共享组件和 Figma/code 一致性。
ccdawn-frontend-engineering：把已确定的界面契约实现为生产级前端代码并做运行时验证。
ccdawn-ai-research-loop：复现 baseline，推进假设、实验、消融与研究方向收敛。
ccdawn-feature-reuse-research：为复杂功能评估项目内外可复用方案。

懒人安装

不想手动 clone、找目录或运行命令时，把下面的提示词直接发给 Codex。

请帮我一键安装 CCDawn 的 Codex skills 技能包。

仓库地址：https://github.com/CCDawn/codex-skills.git

要求：
1. 如果本机已有这个仓库，就进入仓库并更新到最新 main；如果没有，就 clone 到一个合适的本地目录。
2. 只安装到当前用户的 Codex live skills 目录：~/.codex/skills。
3. 不要安装到 ~/.agents/skills，避免重复 slash-command。
4. 先运行安装演练，再执行正式安装。
5. 安装后验证 live skills 是否可用。
6. 使用安装脚本默认可逆停用安装器识别的完整 Superpowers 自动发现入口集，保留原目录和内容，不要删除。
7. 允许安装器在 ~/.codex/AGENTS.md 中安装受管的 CCDawn BRT 激活块；必须保留用户已有规则，并确保可单独卸载。
8. 最后用中文汇报：仓库位置、安装目录、安装了哪些 skills、BRT 激活状态、冲突入口处理、验证是否通过、是否需要重启 Codex。
9. 重点提醒我：最重要入口是 ccdawn-brt；用户正常说需求即可。意图明确时直接推进；意图不清且误解会返工时，BRT 要先说明当前理解和依据，一次集中讨论 2-4 个高影响问题并给出推荐。需求对齐后，若原生 thread 能力可用，BRT 会发现同项目现有平级会话；只在各自任务受益或能减少全局冲突/返工时协作，不创建子 Agent、不转移任务 owner。需要持续自动开发、冲突恢复和本地 main 集成时，BRT 只询问一次是否开启 ccdawn-autonomous-collaboration-loop。

如果遇到 Git、Python、网络、权限问题，只问我一个最关键的阻塞问题。

需要更严格限制写入范围时，用强约束版安装提示词。

完整 Skill 目录

工程流程

ccdawn-brt
CCDawn 最重要入口 skill。高置信度任务直接推进；低置信度且误解会返工时，先查证，再用一轮讨论式追问确认结果、范围、非目标和验收。每个问题提供具体推荐、理由和错判影响，用户可以只纠正不对的项。
ccdawn-autonomous-collaboration-loop 用户明确开启后，持续协调同项目现有会话完成各自任务，普通冲突自动协商，最大冲突只暂停重叠面，并由可接管的 owner 恢复任务、验证合入本地 main 和安全收尾。
ccdawn-multi-agent-orchestration BRT 对齐并发现双向协作价值后的多会话协议。它不创建子 Agent 或派发任务；各平级 Agent 继续完成自己的原任务，只协商共享契约、依赖、冲突和集成责任。
ccdawn-thread-coordination 同一项目多会话协调 owner。用跨 worktree 的 live registry 共享任务、scope 和 checkpoint；通过收敛讨论、暂停握手和 merge order 减少冲突与回归。
ccdawn-development-cleanup 只在已知产生临时残留、branch/worktree/claim，或用户明确要求时加载；安全清理可证明无用且已吸收的开发噪音。
ccdawn-ui-design UI/UX 专项 owner，负责信息层级、交互状态、响应式、无障碍和浏览器视觉验证；机械前端小改不会自动升级成设计流程。
ccdawn-visual-design 视觉方向 owner，根据产品、品牌和受众决定字体、色彩、构图、图像、图标和动效语言，避免脱离语境的模板化 UI。
ccdawn-ui-review 已有界面审查 owner，以真实用户任务和浏览器证据检查体验、视觉层级、状态、响应式、无障碍和设计系统一致性。
ccdawn-design-system 设计系统治理 owner，只处理跨消费者的 token、主题、组件 API、variants、Figma/code 映射和渐进迁移。
ccdawn-frontend-engineering 前端生产实现 owner，在界面结果明确后负责组件、状态、响应式和无障碍实现，并使用真实浏览器证据收口。
ccdawn-feature-reuse-research 只在复用候选会实质改变复杂功能的架构、依赖或实现范围时调研现有项目、库、标准、示例和项目内模块。
ccdawn-planning 只在真实设计分叉、高风险顺序或跨边界交接需要可复用方案时触发；存在独立 owner、依赖或验证边界时在同一方案内生成最小任务图，否则由当前 owner 直接实施。
ccdawn-bdd-tdd-development 仅对预期已明确的新行为或高风险实现契约使用紧凑 TDD；未知根因和 bug 修复仍由 Bug Review 全程持有。
ccdawn-completion-summary 只为跨阶段/会话恢复、正式交接或独立证据包生成紧凑总结；普通实现由当前 owner 直接收口，不生成固定账本。
ccdawn-pr-review PR 审阅阶段 skill，用来把 PR、分支、提交范围或本地 diff 对照已确认需求、任务证据、回归风险和合并准备度进行审查。
ccdawn-project-review 项目审查 skill，用来审查整个仓库、架构、技术债、测试缺口、可维护性、接手状态和项目健康。
ccdawn-simplification-review 当前 diff 的精简审查 skill，用来寻找可删除代码、原生/标准库替代、无效抽象和不必要依赖；不替代正确性审查。
ccdawn-simplification-audit 整仓或子系统精简审计 skill，用来形成证据化复杂度 findings 和按风险排序的精简队列。
ccdawn-bug-review 紧凑 bug owner，直接完成证据收集、根因定位、最小修复和验证；必要 RED/GREEN 作为内部测试锚点，不再切换 TDD owner。
ccdawn-performance-engineering 只承接 PROFILE：以代表性负载建立 baseline、定位主要瓶颈、实施一个最小优化并同负载复测；普通功能留在当前 owner 的 FAST/CHECK，不强制 benchmark。
ccdawn-code-structure-guard 对本轮手写源码执行 STAY/CHECK/SPLIT 结构闸门；行数只触发检查，只有职责、变化或测试边界可分时才拆分。
ccdawn-evaluation CCDawn 评估适配器，只在没有更具体的 review、debug、planning、verification、feedback 或 goal skill 承接时使用。
ccdawn-dawn-agent-html-memory
按用户或项目选择维护跨会话决策、blocker 和正式 handoff；不接管当前执行循环，也不逐 task 同步或渲染。
ccdawn-goal-loop
只处理用户明确要求的开放式持续迭代策略；普通有限任务和“继续完成”仍由当前 owner 连续执行。

研究流程

ccdawn-ai-research-loop AI 研究工程主流程，负责 baseline 复现、可证伪假设、最小实验、多轮 findings 综合，以及继续、分支、转向或停止决策。
ccdawn-research-rigor-review 重要 baseline、反直觉结果和论文级结论晋升前的轻量严谨性审查；普通实验 lane 不强制触发。
ccdawn-competition-research-lifecycle
只在请求跨越多个竞赛/benchmark 阶段时协调规则、数据、baseline、claim 和提交依赖；具体工作交给当前最具体 owner，不强制逐阶段 gate 或并行 lane。

竞赛与评分

ccdawn-score-loop 用于反复 metric 晋升、榜单反馈或提交迭代；AI Research 中可直接完成的一次低成本比较不额外加载本 skill。
ccdawn-huawei-nslb-score-loop
Huawei Algorithm Challenge 37 NSLB 项目的 score loop 适配层，基于通用模板保留项目命令、ledger、mutation space、online feedback 和打包规则。

创意工具

ccdawn-creative-toolbox
这是一个上下文创意生成 skill，用来做 concept collision、divergent thinking、Naming Forge、新概念生成、范式探索、产品想法、研究概念和非常规但有用的方向生成。

统一管理格式

已发布 skill 统一使用这个目录形状：

skills/<bucket>/<ccdawn-skill-name>/
  SKILL.md
  agents/openai.yaml        # 可选，但推荐用于 Codex 斜杠指令 metadata
  references/               # 可选，用于参考资料、模板、ledger 或 schema
  scripts/                  # 可选，用于 skill 自带辅助工具

规则：

skill-name 必须和 SKILL.md 里的 name 字段一致。
每次 catalog 变化，都同步更新 README.md、README.zh-CN.md、对应 bucket 的 README.md，以及 .claude-plugin/plugin.json。
正式安装到 ~/.codex/skills/<ccdawn-skill-name> 时，优先运行 install.ps1 / install.sh，或直接调用 Python 安装器，使用真实目录复制。
除非你明确想要重复斜杠条目，否则不要把同一个 skill 同时安装到 ~/.codex/skills 和 ~/.agents/skills。

仓库结构

.claude-plugin/
  plugin.json
AGENTS.md
CLAUDE.md
INSTALL_PROMPTS.md
install.ps1
install.sh
skills/
  competition/
    README.md
    ccdawn-score-loop/
    ccdawn-huawei-nslb-score-loop/
  creative/
    README.md
    ccdawn-creative-toolbox/
  engineering/
    README.md
    ccdawn-dawn-agent-html-memory/
    ccdawn-autonomous-collaboration-loop/
    ccdawn-multi-agent-orchestration/
    ccdawn-thread-coordination/
    ccdawn-development-cleanup/
    ccdawn-brt/
    ccdawn-ui-design/
    ccdawn-visual-design/
    ccdawn-ui-review/
    ccdawn-design-system/
    ccdawn-frontend-engineering/
    ccdawn-feature-reuse-research/
    ccdawn-planning/
    ccdawn-bdd-tdd-development/
    ccdawn-completion-summary/
    ccdawn-pr-review/
    ccdawn-project-review/
    ccdawn-simplification-review/
    ccdawn-simplification-audit/
    ccdawn-bug-review/
    ccdawn-performance-engineering/
    ccdawn-code-structure-guard/
    ccdawn-evaluation/
    ccdawn-goal-loop/
  research/
    README.md
    ccdawn-ai-research-loop/
    ccdawn-research-rigor-review/
    ccdawn-competition-research-lifecycle/
scripts/
  install_codex_library.py

安装细节

也可以直接调用 Python 安装器。Windows PowerShell 推荐用 py -3；macOS/Linux 推荐用 python3。

py -3 scripts\install_codex_library.py

安装器会先运行 CCDawn package validator，再把已发布 skill 复制成真实目录，检查目录名是否和 SKILL.md 的 name 字段一致，并在本机存在 Codex quick_validate.py 时校验 live skill。install.ps1 和 install.sh 默认使用 --process-skill-conflicts disable，并在 ~/.codex/AGENTS.md 安装带边界标记的轻量 BRT 激活块。重复安装只更新受管区段，不覆盖已有规则。

直接调用 Python 安装器时，BRT 激活默认为只报告状态；显式安装或移除：

py -3 scripts\install_codex_library.py --agent codex --brt-activation install
py -3 scripts\install_codex_library.py --agent codex --brt-activation remove
py -3 scripts\install_codex_library.py --agent grok --brt-activation install
py -3 scripts\install_codex_library.py --agent grok --brt-activation remove

移除激活块不会删除 skills，也不会改动 AGENTS.md 中的其他内容。

恢复这些入口：

py -3 scripts\install_codex_library.py --agent codex --process-skill-conflicts restore

直接调用 Python 安装器时，流程冲突和 BRT 激活默认都只警告；要获得与仓库快捷脚本相同的行为，显式加 --process-skill-conflicts disable --brt-activation install。需要单独使用某个 Superpowers skill 时，可先恢复全部入口，再手动保留所需入口；恢复不会改变 CCDawn skills。

只演练安装计划，不改文件：

py -3 scripts\install_codex_library.py --dry-run

列出当前仓库可安装的 skills：

py -3 scripts\install_codex_library.py --list

只验证已经安装到 Codex live 目录的副本，不重新安装：

py -3 scripts\install_codex_library.py --verify-only

只安装部分 skill：

py -3 scripts\install_codex_library.py --skill ccdawn-brt --skill ccdawn-dawn-agent-html-memory

安装目标选项：

py -3 scripts\install_codex_library.py --agent codex         # 默认 live Codex 目标
py -3 scripts\install_codex_library.py --agent grok          # Grok Build 原生目标
py -3 scripts\install_codex_library.py --agent codex-grok    # 只同步 Codex 与 Grok
py -3 scripts\install_codex_library.py --agent agents        # 可选本地 catalog 副本
py -3 scripts\install_codex_library.py --agent claude        # 可选 Claude 全局副本
py -3 scripts\install_codex_library.py --agent codex-agents  # Codex 加 .agents
py -3 scripts\install_codex_library.py --agent all           # 所有支持目标

只有在明确需要重复入口时，才把同一个 skill 同时安装到 .codex/skills 和 .agents/skills。

斜杠指令排查

如果斜杠条目缺失或重复，先按这个顺序排查，不要先改提示词或随手改目录名：

先看 ~/.codex/skills/<ccdawn-skill-name> 里的 live 安装副本，不要只看仓库副本。
检查是否还存在额外的 ~/.agents/skills/<ccdawn-skill-name> 副本；同一个 skill 两边都装时，Codex 里可能出现重复条目。
检查 live 安装副本里的 agents/openai.yaml，并保持它和本仓库里已经验证可用的最小 interface: 结构一致。
如果当前激活且受信任的工作区就是这个仓库，也要检查 .claude-plugin/plugin.json，因为仓库本地 manifest 也可能影响可见条目。
修改 metadata 后先重启 Codex，再在新线程里验证，不要在旧线程里直接下结论。

可选的开发捷径

如果只是临时开发调试，仍然可以把 skills 链接到 ~/.claude/skills。

macOS/Linux：

bash scripts/link-skills.sh

Windows PowerShell：

powershell -ExecutionPolicy Bypass -File .\scripts\link-skills.ps1

不要把这条链接流程当成这个仓库的正式发布/安装方式。

仓库里的元数据索引在这里：

.claude-plugin/plugin.json

真正的 skills 内容在这里：

skills/

安装或更新 live skill 后，重启客户端，让它重新加载本地 skills。

开发

安装后可运行一条低成本、只读的真实 Codex 路由回归：

py -3 scripts\run_brt_routing_eval.py

默认只检查模糊需求是否先进入 BRT 对齐且不做全仓扫描；--all 才运行完整专项路由样本。

Grok Build 安装后可用 grok inspect --json 确认 ccdawn-brt 的 source 指向 ~/.grok/skills/ccdawn-brt/SKILL.md，并在新 Grok 会话中加载 ~/.grok/AGENTS.md。

使用方式

安装后建议把 ccdawn-brt 作为主入口。用户不需要记固定口令或主动声明流程，正常说需求即可，例如：

修一下这个登录 bug
帮我审这个 PR
先审查一下这个项目结构
我要加一个复杂编辑器功能
这个 benchmark 分数退化了，帮我分析并继续优化
帮我把这个目标拆成可验证的执行计划
帮我给这个仓库初始化项目记忆
另一个会话也在改这些文件，协调一下并在完成后通知它恢复

BRT 会根据意图置信度控制交流成本：

需求明确：直接执行或路由，不为了展示流程而追问。
需求存在多种合理解释：先读取可查证的上下文，再用一条消息集中讨论 2-4 个会改变结果的问题。
讨论时 agent 会先说明当前理解、依据和推荐；用户可以回复 按推荐，也可以只指出需要修改的编号。
信息足够后立即继续，不重复确认已经对齐的内容；只有缺少不可替代输入时才单独询问阻塞问题。
对齐后的非简单项目任务会在原生 thread 能力可用时静默发现同项目会话；只有双方原任务都能受益或全局冲突/返工会降低时才建立平级协作。

例如输入 优化一下这个页面，但我还不确定应该优先改视觉还是操作流程，BRT 应先结合现有页面形成判断，再与用户讨论目标结果、改动范围和验收方式，而不是直接改代码或只路由到 UI skill。

这个仓库按本地 skill library 维护。

Codex Skills

README