Show HN: QUALITY.md – 开放格式/规范、智能体技能及命令行工具
Show HN: QUALITY.md – open format/specification, agent skill, and CLI

原始链接: https://getquality.md

**QUALITY.md** 是一种开放、厂商中立的文件格式,旨在标准化项目质量的定义与维护方式。通过创建一个整体的、机器可读的准则,它使人类和 AI 代理对“良好”达成统一的定义,从而将质量管理从主观直觉转变为一种明确的、主动的过程。 该格式允许团队定义针对特定任务的质量因素(如安全性、可维护性及测试标准)及其背后的背景信息。它由 `qualitymd` 命令行工具和智能体技能提供支持,使团队能够: * **评估:** 根据定义的准则对项目进行评估。 * **改进:** 生成具有优先级的、可操作的建议。 * **循环:** 根据评估结果持续完善模型。 虽然传统的质量模型往往过于复杂而不便于通用,但 AI 的出现使得 `QUALITY.md` 变得极具易用性,能够对任何领域(不仅限于软件)进行推断性的、全面的评估。它作为战略层,补充了现有的程序规则文件(如 `CLAUDE.md`),提供了指导智能体和开发者进行技术工作的“内容”与“原因”。最终,`QUALITY.md` 将维护工作转化为一种经过深思熟虑、可重复的实践,从而积累经验并逐步提升项目标准。

抱歉。
相关文章

原文

Open formatAgent skillCLI

Engineer loops to improve project quality, aligning your team and agents on what quality means for what matters most.

What is QUALITY.md?

QUALITY.md is anopen file formatfor declaring a project quality model: a holistic rubric of the desired quality characteristics (security, maintainability, code quality, test/spec quality, etc.), their quality requirements (guides, sensors, principles, standards, rules, specs), and the context (mission/purpose, user/stakeholder needs, risks, etc.) for why they matter.

The QUALITY.md formatspecificationis designed to be agent, tool, and vendor agnostic. The companion /qualityagent skilland qualitymdCLIserve as both a reference implementation and starter kit for working with QUALITY.md files, including the ability to create a comprehensivequality evaluation reportwith prioritizedimprovement recommendationsready for handoff or further review, useful for engineering quality loops or augmenting your existing workflow.

Why QUALITY.md?

  • Ensure stakeholders are aligned on what matters most and why
  • Identify the most impactful and low risk quality improvements
  • Build agentic control loops to continuously maintain and improve quality
  • Manage quality proactively instead of reactively
  • Tackle intent, comprehension, and technical debt
  • Move judgement and taste up the loop stack
  • Compound learning at the highest leverage point

Philosophy

Maintaining the quality of a thing is caring for it. When a thing exists for the benefit of another, caring for it well is caring for the other well.

The aim of QUALITY.md is to help others care well by making the practice of maintenance accessible to humans and agents.

How to use QUALITY.md?

Set up

  1. Install the /quality agent skill:

    npx skills add qualitymd/quality.md
    
  2. Install the qualitymd CLI:

    npm install -g quality.md
    

    See getting started for other install methods.

  3. Invoke /quality setup to create a tailored QUALITY.md for evaluation and continued refinement.

Act

Hand off quality improvement recommendations to inner agent loops, teammates, or the workflow best suited to the change.

Improve

Run /quality improve to refine QUALITY.md from what the evaluation and improvement work revealed.

Loop

Return to Evaluate with a sharper model and continue compounding quality learning.

Quickstart

Create your first QUALITY.md to establish a project quality model.

Engineer the Quality Loop

Elevate quality evaluation and improvement up the loop stack.

Example quality evaluation

See project quality ratings by project area and quality factor.

Specification

The open, vendor-neutral, QUALITY.md standard.

/quality agent skill

Effortlessly set up, evaluate, and improve.

CLI reference

QUALITY.md linting and management utilities.

FAQ

The specification defines the file format and its meaning: document structure (YAML frontmatter plus a Markdown body), the frontmatter schema for areas, factors, requirements, and the rating scale, naming and reference rules, and model semantics (how sources resolve, how requirements scope to their declaring area, how factors connect, and what the rating scale means). Conformance is a property of documents; the spec doesn’t prescribe or certify any evaluation method. It’s deliberately agent-, tool-, and vendor-agnostic. The /quality skill and qualitymd CLI are companions — a reference implementation and starter kit, not part of the format itself.

No. The format is domain agnostic: it applies wherever you want to be deliberate about quality — documentation sets, data products, research reports, service operations, and more. There’s no default factor checklist to import; each model earns its factors from the modeled thing’s own needs and risks.

Yes. The specification, /quality agent skill, and qualitymd CLI are all developed in the open at github.com/qualitymd/quality.md and released under the MIT license.

They’re complementary layers. Rules files like AGENTS.md or CLAUDE.md tell an agent how to work in your project, and skills give it procedures for specific tasks — both steer the inner coding loop, action by action. QUALITY.md declares what quality means: the shared bar the resulting work is judged against. The /quality skill connects the two — it reads your QUALITY.md to evaluate the project and produces recommendations you can hand off to any agent, teammate, or workflow. In loop terms, rules and skills guide the inner loop; QUALITY.md powers the evaluation and improvement loops above it.

联系我们 contact @ memedata.com