关于 hrt-artifact-lint
hrt-artifact-lint 用于检查包含 proposal、spec、design 和 task 文档的变更目录,报告结构问题与规模信息,并支持仅检查 proposal 的早期阶段模式。
主要功能
- 01检查文档结构与规模
- 02支持仅检查 proposal
- 03报告错误和警告
- 04提供带行号的诊断
- 05工具不可用时改为手动检查
适用场景
- 01继续工作前验证文档
- 02后续文件尚未创建时检查 proposal
- 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