propagate-design-change
Impact analysis tool for design changes, mapping SRS updates to ADRs and user stories.
Install
mkdir -p .claude/skills/propagate-design-change && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/17185" && unzip -o skill.zip -d .claude/skills/propagate-design-change && rm skill.zipInstalls to .claude/skills/propagate-design-change
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
分析 SRS 变更影响,找到受影响的 ADR 与 Story,列出需更新的文档清单。Key capabilities
- →Read changed SRS files
- →Extract referenced modules, ADRs, and user stories
- →Build an impact dependency graph
- →List affected documents by category
- →Generate a change propagation report
- →Provide update suggestions for affected documents
How it works
The skill reads the changed SRS, extracts dependencies, builds an impact graph by searching across ADRs, Epics, and Stories, and then generates a report listing affected documents and update recommendations.
Inputs & outputs
When to use propagate-design-change
- →Analyze design change impact
- →Update ADRs from SRS
- →Map SRS changes to stories
About this skill
propagate-design-change — 设计变更传播分析
技能目的
当某个 SRS 发生变更时,分析依赖图,找到受影响的 ADR、架构文档、Epic、Story 及其他文档,生成需更新的文档清单,确保变更影响全面覆盖。
参数说明
[变更的SRS路径]:发生变更的 SRS 文件路径,例如docs/srs/auth.md。
分阶段工作流
阶段 1:读取变更的 SRS
- 输入:SRS 路径参数
- 处理:
- 使用 Read 读取变更后的 SRS 文件
- 使用 Grep 提取 SRS 中引用的其他模块、ADR、用户故事
- 使用 Read 读取
docs/systems-index.md获取模块依赖关系
- 输出:变更 SRS 内容 + 依赖信息
阶段 2:构建影响依赖图
- 输入:SRS 变更内容 + 依赖信息
- 处理:
- 使用 Grep 在所有 ADR 中检索是否引用了该 SRS
- 使用 Grep 在所有 Epic 与 Story 中检索是否依赖该 SRS 的需求
- 使用 Glob 扫描
docs/adr/*.md、docs/epics/*.md、docs/stories/*.md - 构建变更影响传播图(直接依赖 + 间接依赖)
- 输出:影响依赖图
阶段 3:列出受影响文档
- 输入:影响依赖图
- 处理:
- 分类列出受影响文档:ADR、架构文档、Epic、Story、控制清单
- 为每个受影响文档标注影响程度(高/中/低)
- 标注具体受影响的章节或条目
- 通过 AskUserQuestion 与用户确认影响范围
- 输出:受影响文档清单
阶段 4:生成变更传播报告
- 输入:受影响文档清单
- 处理:
- 使用 Write 生成
docs/change-impact-report.md - 报告包含:变更摘要、影响图、受影响文档清单、建议操作
- 为每个受影响文档提供更新建议
- 使用 Write 生成
- 输出:变更传播报告文件
协作协议引用
- 遵循
.claude/docs/templates/collaborative-protocols/design-agent-protocol.md变更管理规范 - 报告写入前需经用户确认影响范围
- 变更传播报告是后续更新操作的依据
推荐下一步
根据变更传播报告逐个更新受影响文档。更新 ADR 使用 /architecture-decision,更新 Story 使用 /create-stories。更新完成后使用 /consistency-check 验证一致性。
When not to use it
- →When the change does not involve an SRS
- →When not needing to track dependencies across ADRs, Epics, and Stories
Limitations
- →Requires the SRS path as an argument
- →Relies on specific document structures (e.g., `docs/adr/*.md`)
- →Output report needs user confirmation before writing
How it compares
This skill automates the analysis of SRS change impact across various document types and generates a structured report, which is more thorough than manual dependency tracking.
Compared to similar skills
propagate-design-change side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| propagate-design-change (this skill) | 0 | 1mo | No flags | Intermediate |
| pmbok-project-management | 38 | 9mo | No flags | Intermediate |
| project-planner | 32 | 10mo | Review | Intermediate |
| spec-kit-workflow | 11 | 8mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
pmbok-project-management
jgtolentino
Comprehensive PMP/PMBOK project management methodologies and best practices. Use this skill when users need guidance on project management processes, templates, knowledge areas, process groups, tools, techniques, or certification preparation. Covers all 10 PMBOK Knowledge Areas and 5 Process Groups with practical templates, frameworks, and industry-standard approaches. Includes risk management, stakeholder engagement, schedule management, cost control, quality assurance, and resource planning.
project-planner
adrianpuiu
Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking. Use when starting a new project, defining specifications, creating technical designs, or breaking down complex systems into implementable tasks. Supports user story format, acceptance criteria, component design, API specifications, and hierarchical task decomposition with requirement traceability.
spec-kit-workflow
jmanhype
Guides specification-driven development workflow. Automatically invoked when discussing new features, specifications, technical planning, or implementation tasks. Ensures proper workflow phases (specify → clarify → plan → checklist → tasks → analyze → implement).
product-manager-toolkit
davila7
Comprehensive toolkit for product managers including RICE prioritization, customer interview analysis, PRD templates, discovery frameworks, and go-to-market strategies. Use for feature prioritization, user research synthesis, requirement documentation, and product strategy development.
planning-agent
parcadei
Planning agent that creates implementation plans and handoffs from conversation context
pdd
mikeyobrien
Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.