用途:story-integrate 是用户故事流水线(story-define → story-plan → story-implement)的收尾步骤,用于在本地完成并集成一个已实现的用户故事(US-XXX)。它先核验条件,再执行合并。
主要能力:验证分支名符合 feature/US-XXX-[nombre-corto]、工作区干净、US 目录 docs/specs/user-stories/US-XXX-[nombre-corto]/ 及其中 progress.md 存在、所有任务状态为 Done,并需先执行 code-review(default 修饰符)且结论为“Apto”(✅)。随后解析基线分支并执行 git merge --no-ff <feature-branch> -m "Merge US-XXX: <nombre-corto>",最后报告源分支、目标分支、集成的提交数、合并提交哈希与 HEAD 状态。
必要用法:用 git branch --show-current 检测当前分支,git status --porcelain 检查工作区,git rev-list --count <base>..HEAD 统计待集成提交,git checkout <base> 切换基线分支。基线分支优先由 git reflog show <branch> 的 Created from 推断,其次用 git config --get branch.<branch>.merge,二者都无法确定时必须询问用户,不默认 main/master/develop。需要询问用户时应使用客户端提供的结构化提问工具(可点选选项),无此工具时以散文加编号选项回退。存在冲突时立即 git merge --abort 并列出冲突文件,不自动解决,也不使用 --strategy=ours/theirs。
适用场景:单个 US 在 feature/US-XXX-… 分支上实现完毕、progress.md 全部 Done、代码审查通过后,将其合入本地基线分支。
限制:只做本地合并,不 push、不删分支、不创建 MR/PR、不解决冲突、不修改 progress.md;不合并格式不符的分支(如缺 feature/ 前缀);工作区不干净或存在未 Done 任务时阻止合并;任务状态仅 Pending、In Progress、Done 有效;一次只处理一个 US;冲突中止后需用户新指令才可继续。该仓库路径为 https://www.skills.sh/juanca202/sdd-devkit/story-integrate,其余安装方式与依赖暂未提供。