.—————————————————————. |’||’ ‘|’ ‘||’ .|’’’.| ‘||’’’’| ‘||’’|. ‘||’ ‘|’ .|’’’.| | | ‘|. .’ || ||.. ’ || . || || || | ||.. ’ | | || | || ‘’|||. ||’’| ||’’|’ || ‘’|||. | | ||| || . ‘|| || || |. || . ‘||| | | .||. |’….|’ .||…..| .||. ‘|’ .||. |’….|’ | ‘—————————————————————’

Viserys

面向 AI 编码代理的工程化工作流技能。

Viserys 是一个自包含的 Markdown 工作流、审查角色与验证脚本合集。它为代理提供覆盖完整开发生命周期的一致流程，而不是让它在每个任务上即兴发挥。

DEFINE -> PLAN -> BUILD -> VERIFY -> REVIEW -> SHIP

内容一览

路径	内容
`skills/`	28 个 `SKILL.md` 工作流，包含步骤、退出标准与反合理化对照表
`agents/`	4 个审查角色
`references/`	按需加载的共享检查清单
`commands/`	生命周期命令定义
`evals/`	技能的评估用例与测试固件
`scripts/`	验证器与评估运行器
`hooks/`	会话生命周期钩子
`docs/`	内部文档

技能

DEFINE

技能	适用场景
`idea-refine`	概念尚不清晰，需要结构化探索
`interview-me`	需求描述不完整，需要通过逐个提问来提取需求
`spec-driven-development`	启动项目、功能或重大变更，但还没有规格说明
`constraint-driven-development`	没有成文的质量标准，或为求绿灯而禁用了检查

PLAN

技能	适用场景
`get-schema`	已有获批的 PRD，需要在实现前设计数据库模式
`get-tasks`	已有获批的 PRD 或规格说明，需要生成可执行的任务文件
`planning-and-task-breakdown`	已有规格说明，需要带验收标准的有序、可验证任务

BUILD

技能	适用场景
`incremental-implementation`	变更涉及多个文件，应以小切片方式落地
`test-driven-development`	实现逻辑、修复缺陷或修改行为
`context-engineering`	建立会话、切换任务，或输出质量下降时
`source-driven-development`	正确性取决于最新的官方文档
`doubt-driven-development`	风险很高，现在低成本验证一个自信的答案，好过之后调试
`frontend-ui-engineering`	构建或修改面向用户的界面
`api-and-interface-design`	设计 API、模块边界或公共接口

VERIFY

技能	适用场景
`browser-testing-with-devtools`	构建或调试任何在浏览器中运行的内容
`debugging-and-error-recovery`	测试失败、构建中断或行为不符合预期时

REVIEW

技能	适用场景
`code-review-and-quality`	合并任何变更之前
`code-simplification`	代码能运行，但可读性或可维护性低于应有水平
`security-and-hardening`	涉及用户输入、认证、数据存储或外部集成
`performance-optimization`	存在性能要求或疑似出现性能回退

SHIP

技能	适用场景
`git-workflow-and-versioning`	进行任何代码变更时
`ci-cd-and-automation`	搭建或修改构建与部署流水线
`deprecation-and-migration`	下线旧系统或迁移用户
`documentation-and-adrs`	记录架构决策或修改公共 API
`observability-and-instrumentation`	添加日志、指标、追踪或告警
`shipping-and-launch`	准备部署到生产环境

技能	适用场景
`using-agent-skills`	判断哪个工作流适用于当前请求

审查角色

代理	视角
`agents/code-reviewer.md`	五轴评审，以“资深工程师会批准这段代码吗？”为标准
`agents/test-engineer.md`	测试策略、覆盖率分析与“拿出证据”模式
`agents/security-auditor.md`	漏洞检测、威胁建模、OWASP 评估
`agents/web-performance-auditor.md`	提供快速与深度两种模式的 Core Web Vitals 审计

OpenCode 中的 Viserys 模式

本仓库在 .opencode/agent/viserys.md 中附带了一个 OpenCode 代理定义，并通过 .opencode/opencode.json 注册其技能。

激活方式：

克隆本仓库。
用 OpenCode 打开仓库文件夹。
按 Tab 并选择 viserys。

viserys 代理以主模式（primary mode）运行，因此会出现在代理列表中。它的提示词会将每个请求路由到生命周期技能，并强制执行“先查是否有对应技能”的规则。技能路径由 .opencode/opencode.json 注册，因此该技能包的 28 个技能无需任何全局配置即可加载。

用法

支持技能的代理（Claude Code、OpenCode、Cursor 等）：将代理指向 skills/ 目录，或将该目录复制到代理的原生技能位置。当任务匹配时，代理会调用相应技能。

普通上下文：每个技能都是独立的 Markdown 文件。阅读相关文件并遵循其流程即可。

验证

node scripts/validate-skills.js
node scripts/validate-commands.js
node scripts/validate-artifact-paths.js
node scripts/validate-reference-links.js
node scripts/validate-versions.js
node scripts/run-evals.js

文档

docs/README.md — 技能包概览与生命周期地图
docs/skill-anatomy.md — SKILL.md 格式规范
evals/README.md — 技能评估的工作方式

viserys-agent：为 AI 编码代理打造的全生命周期工程工作流技能包