重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
blueprint-adr-validate by laurigates/claude-plugins
npx skills add https://github.com/laurigates/claude-plugins --skill blueprint-adr-validate包含 Shell 命令
此技能包含可能执行系统命令的 shell 命令指令(!command``)。安装前请仔细审查。
验证架构决策记录的关系一致性、引用完整性和领域冲突。
用法 : /blueprint:adr-validate [--report-only]
| 使用此技能当... | 使用替代方案当... |
|---|---|
| 发布前维护 ADR 完整性 | 创建新的 ADR(使用 /blueprint:derive-adr) |
| 重构或变更后进行审计 | 快速的一次性文档审查 |
| 常规文档审查流程 | 一般性的 ADR 阅读 |
find docs -maxdepth 1 -name 'adrs' -type d广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
find docs/adrs -name "*.md" -type fgrep -l "^domain:" docs/adrs/*.mdecho "${1:---}"解析 $ARGUMENTS:
--report-only: 输出验证报告而不提示修复
执行完整的 ADR 验证和修复工作流:
docs/adrs/ 目录是否存在ls docs/adrs/*.md对于每个 ADR,验证:
详细检查请参见 REFERENCE.md。
编译全面的报告,显示:
如果存在 --report-only 标志:
通过 AskUserQuestion 询问用户操作:
docs/adrs/validation-report.md根据选择执行(参见 REFERENCE.md)。
更新 docs/blueprint/manifest.json 中的任务注册表条目:
jq --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
--arg result "${VALIDATION_RESULT:-success}" \
--argjson processed "${ADRS_VALIDATED:-0}" \
'.task_registry["adr-validate"].last_completed_at = $now |
.task_registry["adr-validate"].last_result = $result |
.task_registry["adr-validate"].stats.runs_total = ((.task_registry["adr-validate"].stats.runs_total // 0) + 1) |
.task_registry["adr-validate"].stats.items_processed = $processed' \
docs/blueprint/manifest.json > tmp.json && mv tmp.json docs/blueprint/manifest.json
其中 VALIDATION_RESULT 是 "success"、"{N} warnings" 或 "failed: {reason}"。
报告所有已做的更改:
| 上下文 | 命令 |
|---|---|
| 检查 ADR 目录 | `test -d docs/adrs && echo "YES" |
| 统计 ADR 数量 | `ls docs/adrs/*.md 2>/dev/null |
| 提取前置元数据 | `head -50 {file} |
| 按领域查找 | grep -l "^domain: {domain}" docs/adrs/*.md |
| 检测循环 | 构建 supersession 图并进行遍历 |
有关验证规则、修复程序和报告格式的详细信息,请参见 REFERENCE.md。
每周安装
49
仓库
GitHub 星标
23
首次出现
2026年2月9日
安全审计
安装于
opencode49
gemini-cli49
github-copilot49
codex49
amp49
cline49
Contains Shell Commands
This skill contains shell command directives (!command``) that may execute system commands. Review carefully before installing.
Validate Architecture Decision Records for relationship consistency, reference integrity, and domain conflicts.
Usage : /blueprint:adr-validate [--report-only]
| Use this skill when... | Use alternative when... |
|---|---|
| Maintaining ADR integrity before releases | Creating new ADRs (use /blueprint:derive-adr) |
| Auditing after refactoring or changes | Quick one-time documentation review |
| Regular documentation review process | General ADR reading |
find docs -maxdepth 1 -name 'adrs' -type dfind docs/adrs -name "*.md" -type fgrep -l "^domain:" docs/adrs/*.mdecho "${1:---}"Parse $ARGUMENTS:
--report-only: Output validation report without prompting for fixes
Execute complete ADR validation and remediation workflow:
docs/adrs/ls docs/adrs/*.mdFor each ADR, validate:
See REFERENCE.md for detailed checks.
Compile comprehensive report showing:
If --report-only flag present:
Ask user action via AskUserQuestion:
docs/adrs/validation-report.mdExecute based on selection (see REFERENCE.md).
Update the task registry entry in docs/blueprint/manifest.json:
jq --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
--arg result "${VALIDATION_RESULT:-success}" \
--argjson processed "${ADRS_VALIDATED:-0}" \
'.task_registry["adr-validate"].last_completed_at = $now |
.task_registry["adr-validate"].last_result = $result |
.task_registry["adr-validate"].stats.runs_total = ((.task_registry["adr-validate"].stats.runs_total // 0) + 1) |
.task_registry["adr-validate"].stats.items_processed = $processed' \
docs/blueprint/manifest.json > tmp.json && mv tmp.json docs/blueprint/manifest.json
Where VALIDATION_RESULT is "success", "{N} warnings", or "failed: {reason}".
Report all changes made:
| Context | Command |
|---|---|
| Check ADR directory | `test -d docs/adrs && echo "YES" |
| Count ADRs | `ls docs/adrs/*.md 2>/dev/null |
| Extract frontmatter | `head -50 {file} |
| Find by domain | grep -l "^domain: {domain}" docs/adrs/*.md |
| Detect cycles | Build supersession graph and traverse |
For validation rules, remediation procedures, and report format details, see REFERENCE.md.
Weekly Installs
49
Repository
GitHub Stars
23
First Seen
Feb 9, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode49
gemini-cli49
github-copilot49
codex49
amp49
cline49
Skills CLI 使用指南:AI Agent 技能包管理器安装与管理教程
52,700 周安装