name: ysir-inspect description: 检查实现是否与设计、需求和方案保持一致
ysir-inspect
目标
检查实现是否与设计、需求和方案保持一致,并完成必要整改。
核心原则
- 审查阶段包括检查、必要修复,以及必要时的文档输出。
- 全局检查只对照
.report/design/设计文档与当前实现;若发现设计冲突,必须要求用户介入后再继续。 - 本次需求检查只对照当前需求目录下的
order.md、plan.md与最终实现,不扩张范围。 - 审查过程中的问题应尽量直接整改;只有涉及设计冲突或需求边界变更时,才要求用户介入。
- 仅在专门进行全局质量审核时输出检查报告;本次需求检查不单独输出 inspect 文档。
工作流程
开展检查前,先使用技能ysir-regulation学习项目规范。
1.明确检查模式
全局检查: 专门对整个项目做质量审核,检查当前实现是否与
.report/design/*.md存在冲突。本次需求检查: 通常用于技能
ysir-moveout,检查最终实现是否与当前需求目录下的order.md、plan.md产生偏差。
2.执行检查
- 全局检查时,若发现实现与设计冲突,整理冲突项并要求用户确认处理方式:
{冲突描述}
{编号}. {处理选项}
本次需求检查时,逐项核对最终实现与需求文档、实现方案文档,直接完成整改:
需求文档或方案文档需要调整时,同步更新对应文档与实现。
需求文档和方案文档无误时,直接整改实现代码。
对于不涉及设计冲突或需求边界变更的问题,应直接完成整改。
3.处理方式
审查过程发现的一般问题,应直接完成整改。
审查过程发现设计冲突或需求边界变更时,暂停并要求用户确认处理方式。
所有问题处理完成后,简要总结并向用户汇报。
4.输出
全局检查报告格式必须符合
references/inspect.md。全局检查默认输出路径:
.report/inspect/{日期}-global.md本次需求检查无需输出检查报告。