PR

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.zip

Installs 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,列出需更新的文档清单。
42 charsno explicit “when” trigger
Intermediate

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

You give it
path to the changed SRS file
You get back
change propagation report (`docs/change-impact-report.md`) with affected documents and update suggestions

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 路径参数
  • 处理
    1. 使用 Read 读取变更后的 SRS 文件
    2. 使用 Grep 提取 SRS 中引用的其他模块、ADR、用户故事
    3. 使用 Read 读取 docs/systems-index.md 获取模块依赖关系
  • 输出:变更 SRS 内容 + 依赖信息

阶段 2:构建影响依赖图

  • 输入:SRS 变更内容 + 依赖信息
  • 处理
    1. 使用 Grep 在所有 ADR 中检索是否引用了该 SRS
    2. 使用 Grep 在所有 Epic 与 Story 中检索是否依赖该 SRS 的需求
    3. 使用 Glob 扫描 docs/adr/*.mddocs/epics/*.mddocs/stories/*.md
    4. 构建变更影响传播图(直接依赖 + 间接依赖)
  • 输出:影响依赖图

阶段 3:列出受影响文档

  • 输入:影响依赖图
  • 处理
    1. 分类列出受影响文档:ADR、架构文档、Epic、Story、控制清单
    2. 为每个受影响文档标注影响程度(高/中/低)
    3. 标注具体受影响的章节或条目
    4. 通过 AskUserQuestion 与用户确认影响范围
  • 输出:受影响文档清单

阶段 4:生成变更传播报告

  • 输入:受影响文档清单
  • 处理
    1. 使用 Write 生成 docs/change-impact-report.md
    2. 报告包含:变更摘要、影响图、受影响文档清单、建议操作
    3. 为每个受影响文档提供更新建议
  • 输出:变更传播报告文件

协作协议引用

  • 遵循 .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.

SkillInstallsUpdatedSafetyDifficulty
propagate-design-change (this skill)01moNo flagsIntermediate
pmbok-project-management389moNo flagsIntermediate
project-planner3210moReviewIntermediate
spec-kit-workflow118moNo flagsIntermediate

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.

38183

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.

32115

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).

11111

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.

3280

planning-agent

parcadei

Planning agent that creates implementation plans and handoffs from conversation context

531

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.

66

Search skills

Search the agent skills registry