mcpField
H
hrt-artifact-lint

hrt-artifact-lint

github.com/hash-id测试与质量251 次安装4 天前更新
代码仓库

关于 hrt-artifact-lint

hrt-artifact-lint 用于检查包含 proposal、spec、design 和 task 文档的变更目录,报告结构问题与规模信息,并支持仅检查 proposal 的早期阶段模式。

主要功能

  1. 01检查文档结构与规模
  2. 02支持仅检查 proposal
  3. 03报告错误和警告
  4. 04提供带行号的诊断
  5. 05工具不可用时改为手动检查

适用场景

  1. 01继续工作前验证文档
  2. 02后续文件尚未创建时检查 proposal
  3. 03定位变更文档的结构缺陷

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hash-id/openspec-schema --skill hrt-artifact-lint

安装后在 Claude Code 中输入/hrt-artifact-lint确认已加载。

附带文件lint.cjs

详细介绍

hrt-artifact-lint

针对变更目录运行随附的 lint.cjs(与此文件位于同一目录,安装在 .agents/skills/hrt-artifact-lint/lint.cjs,无依赖项)——该目录包含 proposal.md、specs/、design.md、tasks.md:

node .agents/skills/hrt-artifact-lint/lint.cjs <change-dir>

在 proposal 阶段,如果尚无后续工件,请添加 --phase=proposal,这样运行时只会检查 proposal.md(结构、大小、形式),不会将缺少 specs、design 和 tasks 报告为错误。

输出格式为 LEVEL path:line message,每行一条,最后输出一行 Size facts:(能力、场景、任务组、提案字数;不作判定)。如果有任何 ERROR,则退出码为 1,否则为 0。

  • ERROR:可确定的结构缺陷,且只有一种正确修复方式。直接修复,不询问用户,并记录所做的更改。
  • WARN:非阻塞问题。如果修复很快,就修复。

lint 通过后,调用方不会手动重新运行这些检查。调用方的判断(某个场景是否确实描述行为、某项需求是否确实可测试、某个 N/A 部分是否确实不适用)不在此处检查范围内,仍需执行。

如果缺少 Node 或找不到 lint.cjs,请说明情况,并改为手动检查这些项目。不要默默跳过。

评论

支持 Markdown