verifier-state-architect

Solid

为任意 Agent Skill 设计、实现、接入或精简 Verifier 与 State;当用户希望给目标 skill 配置验证器/状态机、落实已有设计,或仅规划和审查架构时使用,尤其适合需要避免过度设计、硬编码并符合 Kernel 契约的任务。

AI & Automation 48 stars 7 forks Updated today MIT

Install

View on GitHub

Quality Score: 86/100

Stars 20%
56
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Verifier-State Architect ## 目标 为任意领域的目标 Skill 完成业务理解、最小设计、本地实现和验证。Verifier/State 是可插拔外挂,不为展示 Kernel 强行加入;零组件或仅一类组件也可以是正确结果。适合专用组件的新建、现有组件接入与精简,以及已有设计的落实。 默认是设计者兼执行者:人类把目标 Skill 交给本技能后,先保存供 AI 执行、人类事后审查的计划,再连续落地,不等待人类审核计划。仅当用户明确要求“仅计划 / 不修改源码”或只读审查时,分别采用 `plan-only` / `review-only`。不负责普通业务重写、Kernel 修复或提升通用组件、发布及远程操作;这些范围只能另行授权,不能作为默认执行的延伸。 ## 流程 ### 输入 #### 输入与模式 - **必需输入**:目标 Skill 源目录或完整内容、业务目标和已知约束。执行模式需要可写、已授权的源码目录;只有文本时可以设计,但不能假装已经落地,也不擅自创建未知目标。 - **可选输入**:已有计划、Kernel 源码/安装路径、`runtime` 声明、Pack、测试、历史报告和计划路径。读取 `config.yaml` 获取默认模式、输出和检查设置。 - 确认目标是开发源码而非系统级已安装副本;记录未提交改动和允许修改范围。用户指定目标并要求本技能设计/接入,默认授权其必要本地变更,不需要第二次计划审批;纯审查或明确只规划不授权源码写入。 - 已有计划先核对当前源码、版本、范围和验收,局部更新偏差后实施,不无理由重做整套规划。模式、依据与未解决缺口写入计划。 ### 执行步骤 #### 核心工作流 ##### 理解服务对象 读取目标 `SKILL.md`、`config.yaml`、脚本、references、模板、运行声明和适用项目指令;绘制目标、输入/输出、阶段、风险、失败/回退、人工介入和产物。从证据列出稳定命题的 Verifier 候选与持续阶段的 State 候选,不从文件名或关键词臆测。执行前必读本 Skill 的 [托管规范](references/skill-pack-hosting.md) 和 [落地参考](references/implementation.md):前者是托管规则的唯一维护文件,后者仅提供操作指引。在本仓库按需核对 ID 文档与正文模板;仓库外使用随 Skill 安装的规范和实际 Kernel 契约,不依赖本开发仓库的绝对路径。 ##### 删除影响闸门 逐项回答: - 删除 Verifier 是否损失可复核的安全/质量边界,而非只少形式检查? - 删除 State 是否损失恢复、协作、Gate 或阶段可见性,而非只少标签? - 组件是否改变下一步决策、阻止高代价错误、支持重放/审计或提供可行动的人工复核? - 是否已有更通用的内置 Pack/State?只有通用组件无法表达稳定命题时才设计专用组件。 若删除不改变能力、决策或审计性,明确“不接入”;零组件或只保留一个均合法。 ##### Kernel 复用与元组件二层审查 在专用设计前完成以下盘点,避免重复造轮子,也不默认新增 Kernel 功能: 1. 从用户提供的 Kernel 源码或当前 Python 环境定位实际包;本仓库源码位于 `packages/bensz-skill-kernel/src/bensz_skill_kernel`。读取其 `verifiers/index.jso...

Details

Author
huangwb8
Repository
huangwb8/skills
Created
8 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

mini-program-implementation-skill

Implement bounded features and fixes in existing or new mini-program codebases while preserving repository rules, user-owned changes, approved behavior, assets, framework conventions, and evidence boundaries. Use when users ask to write or modify mini-program code, implement a confirmed specification or architecture, add a scoped feature, remove behavior semantically, update internal documentation required by a change, or carry out a well-defined small fix that does not require root-cause investigation. Establishes a baseline and change boundary, applies test-driven small steps, distinguishes source from generators and build artifacts, verifies the affected contract, and never reports source completion as device validation, formal acceptance, upload, or release.

59 Updated 3 days ago
NocodeMrLi
Web & Frontend Listed

build-skill

从零设计、实现和验证通用 Skill 或项目级定制 Skill,也用于审查并重构已有低质量 Skill。

1 Updated 5 days ago
koco-co
Code & Development Listed

first-principles-adversarial-review

必须加载并读取完整 Skill,用第一性原理与对抗式审查处理所有实质性任务;不要因为任务看似可以直接回答而跳过。适用于事实判断、原因解释、需求分析、技术或产品方案、建议与决策、故障诊断、内容或代码评审,以及代码、配置、流程和文档修改,即使用户没有提到这两个术语。所有结论先做与风险相称的对抗式审查;需求、设计、实现、优化和复杂决策再从真实目标、事实、约束、机制、生产者、消费者、上下游与替代方案重新推导。纯翻译、机械改格式、忠实转写和无判断的一步操作不要加载。

2 Updated 4 days ago
Zhangs-11