Agent Skills
› harumiWeb/exstruct
harumiWeb/exstruct
GitHub用于根据 Issue、PR、代码差异及测试规范，起草新的架构决策记录（ADR）或更新现有 ADR。该技能强调区分政策背景与实现细节，提取上下文、决策及其后果，并引用具体证据，确保产出结构化的政策记录而非实施备忘录。
安装全部 Skills
npx skills add harumiWeb/exstruct --all -g -y
集合内 Skills (8)
用于根据 Issue、PR、代码差异及测试规范，起草新的架构决策记录（ADR）或更新现有 ADR。该技能强调区分政策背景与实现细节，提取上下文、决策及其后果，并引用具体证据，确保产出结构化的政策记录而非实施备忘录。
需要为新决策创建 ADR
需要对现有 ADR 进行更新或修订
npx skills add harumiWeb/exstruct --skill adr-drafter -g -y
用于在ADR文件新增、更新或状态变更时，扫描源码并同步生成README、index.yaml和decision-map.md等索引制品，确保元数据一致性。
ADR文件被添加、更新、取代或重新分类
需要刷新供人类或AI代理使用的ADR映射
npx skills add harumiWeb/exstruct --skill adr-indexer -g -y
用于审查ExStruct架构决策记录（ADR）草稿。检查状态值、必需章节、证据质量、替代链接及后果平衡性，按严重程度输出发现项，确保合并前符合治理规范。
收到ADR草稿需要预审查
准备合并或评审架构决策文档
npx skills add harumiWeb/exstruct --skill adr-linter -g -y
审计ADR与规范、测试及源码的一致性，检测策略漂移、缺失更新、陈旧引用等证据缺口。适用于合并后或定期审计场景，输出结构化发现及建议操作，不直接改写文本。
代码合并后
定期ADR审计
怀疑实现与ADR不一致时
npx skills add harumiWeb/exstruct --skill adr-reconciler -g -y
在adr-linter通过后，审查ADR草稿的决策质量、重叠性、证据强度及发布风险。识别需人工介入的决策并输出分级发现与结论（ready/revise/escalate）。
需要合并或交接前的设计评审
adr-linter报告无未解决的高/中危问题后
npx skills add harumiWeb/exstruct --skill adr-reviewer -g -y
用于判断代码变更是否需要架构决策记录(ADR)。通过审查Issue、PR或Diff，结合治理文档和现有ADR，输出必要性 verdict（必需/建议/无需）、理由及后续行动建议。
分析 Issue 或 PR 变更
审查代码 Diff
评估设计决策影响
npx skills add harumiWeb/exstruct --skill adr-suggester -g -y
通过运行脚本获取并格式化 Codacy 分析缺陷。支持按仓库或 PR 筛选，过滤严重程度，解析 JSON 输出以提供可操作的摘要，辅助代码审查与修复规划。
用户要求检查仓库的 Codacy 问题
用户要求检查 Pull Request 的 Codacy 发现
用户需要按严重程度过滤 Codacy 结果
用户需要结构化输出来制定修复计划
npx skills add harumiWeb/exstruct --skill codacy-issues-fetcher -g -y
提供 ExStruct CLI 的 Excel 工作簿创建、编辑与验证指南。通过命令选择、安全规则及分步工作流，指导代理安全执行操作，支持干跑测试和后端约束处理，并在必要时移交 MCP。
需要创建新的 Excel 工作簿
需要编辑现有的 Excel 工作簿
需要对工作簿进行有效性验证或检查可读性
不确定具体操作类型需列出可用操作
需要了解特定操作的详细 schema 或约束条件
npx skills add harumiWeb/exstruct --skill exstruct-cli -g -y
