SSP AI Coding Registry

基于 PROJECT_STATE 和 Execution Contract 的 workflow memory + role skills 下载包

安装与下载

npx shadcn@latest add https://ssp-ui-registry-staging.sh3.agoralab.co/r/ac-skills.json

yarn dlx shadcn@latest add https://ssp-ui-registry-staging.sh3.agoralab.co/r/ac-skills.json

pnpx shadcn@latest add https://ssp-ui-registry-staging.sh3.agoralab.co/r/ac-skills.json

bunx shadcn@latest add https://ssp-ui-registry-staging.sh3.agoralab.co/r/ac-skills.json

下载后会安装以下内容：

ac-memory
ac-workflow
ac-plan
ac-execute
ac-review
ac-frontend-integration
ac-debug-investigator
ac-pr-review
ac-explorer-lite
ac-chore-editor
~/.codex/agents/ac-agent-*.toml

这是什么？

这是一个围绕 workflow 协议设计的 multi-agent skills 包。它把本地记忆与门禁管理、任务编排、核心 triad，以及前端 / 调试 / PR 审查 / 轻量探索与 chore 编辑等角色拆成独立 skill，并为角色层提供对应的 Codex agent 配置。

适用前提：

使用 PROJECT_STATE.md 做跨会话状态接力
使用 PLAN_FROZEN / CURRENT_ROLE 管理执行冻结
使用 Execution Contract 约束 planner -> executor -> reviewer 的交接

如果你想要完整脚手架，请安装 agents-markdown。
如果你已经有自己的协作文档体系，只想复用这套 workflow skills 与 agent 配置，可以单独安装当前 item。

安装结果

路径	作用
`~/.agents/skills/ac-memory/`	`PROJECT_STATE.md` 本地记忆与 workflow 门禁
`~/.agents/skills/ac-workflow/`	workflow 编排入口与阶段路由
`~/.agents/skills/ac-plan/` `ac-execute/` `ac-review/`	核心 workflow triad
`~/.agents/skills/ac-frontend-integration/`	有边界的前端集成与 UI 落地
`~/.agents/skills/ac-debug-investigator/`	Debug 复现、证据收集与根因收敛
`~/.agents/skills/ac-pr-review/`	Findings-first 的风险导向 PR 审查
`~/.agents/skills/ac-explorer-lite/`	低风险只读探索与快速归纳
`~/.agents/skills/ac-chore-editor/`	小范围低风险 chore/edit
`~/.codex/agents/ac-agent-*.toml`	对应的 Codex agent 行为配置

说明：

当前 item 不包含 ~/.codex/config.toml
如果你需要把这些 agent 注册到自己的 Codex 配置中，请按项目实际情况补充 config.toml

模型与 reasoning 策略

这次的默认策略不是“谁负责执行就默认 spark”，而是：

gpt-5.4 作为默认正式工作模型
优先通过 reasoning_effort 区分任务强度
gpt-5.3-codex-spark 只保留给明确轻量、低风险、立即返回的子任务

推荐分层：

任务强度	默认模型	适用场景
`medium`	`gpt-5.4`	已知模式、边界清楚、文件范围有限的实现与集成
`high`	`gpt-5.4`	跨模块集成、代码审查、根因排查、需要权衡方案的任务
`xhigh`	`gpt-5.4`	高风险或高不确定性任务，如 re-plan、复杂调试、公共契约变更、迁移
`medium`	`gpt-5.3-codex-spark`	只读探索、轻量总结、简单问答、极小范围 chore/edit

关于 xhigh：

当前下载包不会为多数 agent 再复制一套 xhigh 静态文件
若运行环境支持 spawn-time override，优先在调用时把对应 agent 提升到 xhigh
若不支持，则继续使用当前静态默认值（通常为 high）

三层角色结构

1. Workflow 基座

ac-memory

检查或创建 PROJECT_STATE.md
校验 PLAN_FROZEN / CURRENT_ROLE
校验固定区块是否齐全
统一维护 [STATE] 状态锚点

ac-workflow

作为 workflow 入口 skill
先通过 ac-memory 确保状态就绪
根据风险路由进入 single 或多角色执行
统一处理 continue 恢复、阶段推进与强制收尾

2. 核心 workflow triad

ac-plan

默认 gpt-5.4 + high
完整填写 Execution Contract
设置 PLAN_FROZEN=true
将执行权交给 ac-execute

ac-execute

默认 gpt-5.4 + medium
只在 PLAN_FROZEN=true 时执行
严格按 Contract 的文件范围与步骤改动
记录 Evidence

ac-review

默认 gpt-5.4 + high
按 Contract 做验收与风险回看
更新 Evidence / Gaps
决定保持冻结还是解冻回到 ac-plan

3. Specialized / lite agents

ac-frontend-integration

默认 gpt-5.4 + medium
用于有边界的 UI 集成、状态接线、样式与交互修复

ac-debug-investigator

默认 gpt-5.4 + high
用于复现问题、收集日志、缩小 root cause
若一次分析后仍高度不确定，推荐运行时提升到 xhigh

ac-pr-review

默认 gpt-5.4 + high
用于 findings-first 的 PR 风险审查与门禁建议
对高风险 diff 可在运行时提升到 xhigh

ac-explorer-lite

默认 gpt-5.3-codex-spark + medium
只做 read-only 探索、检索、快速归纳、简单问题回答
不负责架构判断、复杂调试、最终审查结论

ac-chore-editor

默认 gpt-5.3-codex-spark + medium
只做文案、ignore、命名、窄范围配置等小改动
不负责跨模块实现或复杂特性开发

与 `agents-markdown` 的关系

agents-markdown 是完整脚手架，负责：

.ai-coding/* 初始化文件
AGENTS.md / PROJECT_STATE 相关模板
~/.codex/config.toml

ac-skills 只负责 workflow skills 与对应的 Codex agents。
安装 agents-markdown 时，也会通过 registry 依赖自动带上 ac-skills。

AC Skills