viserys-agent仓库介绍

rizqinrr/viserys-agent

Viserys 是一个自包含的 Markdown 工作流（workflow）、审查者人设（persona）以及校验脚本的合集。它让智能体在完整的开发生命周期中始终遵循一套一致的流程，而不是每遇到一个任务就即兴发挥。

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

目录内容

Path                  Contents
skills/SKILL.md       工作流，包含步骤、退出标准以及反自欺（anti-rationalization）表格
agents/               4 个审查者人设
references/           按需加载的共享清单
commands/             生命周期命令定义
evals/                技能的评估用例与固定测试数据
scripts/              校验器与评估运行器
hooks/                会话生命周期钩子
docs/                 内部文档

技能

DEFINE（定义）

| 技能 | 使用场景 |
| --- | --- |
| idea-refine | 概念仍较模糊，需要结构化的探索 |
| interview-me | 需求描述不明确，必须一次一个问题地挖掘需求 |
| spec-driven-development | 启动一个项目、功能或重大改动，但还没有规格说明 |
| constraint-driven-development | 没有成文的质量标准，或为了通过检查而关闭了某些校验 |

PLAN（规划）

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

BUILD（构建）

| 技能 | 使用场景 |
| --- | --- |
| incremental-implementation | 改动涉及多个文件，应以薄切片（thin slice）方式逐步落地 |
| 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 | 准备部署到生产环境 |

Meta（元）

| 技能 | 使用场景 |
| --- | --- |
| using-agent-skills | 判断当前请求应该套用哪个工作流 |

人设（Persona）

智能体视角

agents/code-reviewer.md         五维度的代码审查，标准是"staff 工程师会不会批准"
agents/test-engineer.md         测试策略、覆盖率分析以及 prove-it 模式
agents/security-auditor.md      漏洞检测、威胁建模、OWASP 评估
agents/web-performance-auditor.md  Core Web Vitals 审计，分快速模式与深度模式

在 OpenCode 中使用 Viserys 模式

本仓库在 .opencode/agent/viserys.md 中内置了一份 OpenCode 智能体定义，并通过 .opencode/opencode.json 注册其技能。

激活方式如下：

1. 克隆本仓库。

2. 用 OpenCode 打开仓库所在目录。

3. 按下 Tab 键，选择 viserys。

viserys 智能体运行在 primary 模式，因此会出现在智能体列表中。它的提示词会把每个请求都路由到相应的生命周期技能，并强制执行"先检查技能"的规则。各技能的路径由（译注：原文此处未完整给出）