用途:从 Sherpy 规划产物生成一份面向开发者的摘要文档,帮助开发人员快速了解要构建的内容、关键交付物和里程碑路线图。
使用方式:命令为 /developer-summary [base-directory]。若未提供目录,会检测当前目录下的 requirements/business-requirements.yaml;找不到时提示“Where are your planning artifacts located?”,并等待用户提供路径。
依赖产物(按标准 Sherpy 目录结构自动发现):requirements/business-requirements.yaml(项目概览与交付物)、requirements/technical-requirements.yaml(技术背景与架构)、implementation/milestones.yaml(里程碑顺序与估算)、delivery/timeline.yaml(时间线与日期)。
流程:先确定基准目录并扫描所需文件、显示依赖检查状态;若有文件缺失,用户可选择继续(缺失部分标记为 [Not Available])或退出;然后解析可用文件,提取项目名称、核心功能、技术栈、里程碑序列与依赖、工期与目标完成日期;生成 summaries/developer-summary.md,内容包括头部(时间戳、项目名)、概览(3-5 句)、交付物(按类别分组)、里程碑与时间线、总结(里程碑总数、估算总工期、目标完成);最后输出确认信息。
交付物提取来源:business-requirements.yaml 的 functional_requirements、features/capabilities、scope.in_scope;technical-requirements.yaml 的 architecture.components、technology_stack、data_model.entities、apis.endpoints、integration_points。按类型归入 API Endpoints、Domain Handlers、UI Components、Data Models、Infrastructure、Integrations、Background Jobs、Configuration 等类别,不强制套用不相关类别。
概览生成:按“做什么、解决什么问题或价值、高层方法”综合来源字段(如 description/overview、business_goals.primary_goal、success_criteria、solution_overview、architecture.approach),最多 5 句,不用列表。
里程碑与时间线:从 milestones.yaml 提取 id、name、description、estimated_duration、dependencies;有 timeline.yaml 时用 total_duration 和 production_deploy_date,仅有时用里程碑工期求和(提示未含 QA/PR 时间),都没有则标 TBD。
限制:需先具备相应规划产物;文件缺失、YAML 无效或字段缺失时给出对应处理并标注;部分规划产物生成技能未在资料中说明具体运行环境,暂未提供。资料中提及相关技能 /executive-summary、/sherpy-flow、/implementation-planner、/delivery-timeline。