mcpField
W
woostack-commit

woostack-commit

github.com/howarewoo开发085 次安装今天更新
代码仓库

关于 woostack-commit

woostack-commit 是用于提交授权任务变更并按要求交付的技能。它保留无关工作不变，支持仅本地提交或发布及维护 PR，并通过回读确认远程更新。

主要功能

  1. 01仅暂存已审查的变更
  2. 02创建本地提交
  3. 03按要求发布或更新 PR
  4. 04支持限定范围的 PR 维护与重排
  5. 05回读确认交付状态

适用场景

  1. 01仅在本地提交授权变更
  2. 02发布任务分支并创建草稿 PR
  3. 03维护指定的 PR 堆栈和就绪状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/howarewoo/woostack --skill woostack-commit

安装后在 Claude Code 中输入/woostack-commit确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
delivery.md
source-control.md
tdd.md
worktrees.md

详细介绍

woostack-commit

提交属于当前已授权结果的更改，并按调用者的要求完成交付。显式执行 /woostack-commit 会发布；仅要求提交的自然语言请求或 --no-pr-update 会在本地提交后停止。Issue 是可选的：提交或更新 PR 不要求 Issue、Project、负责人、生命周期记录或归属署名尾注。

此技能会修改 Git 状态；若要求交付或维护 PR，也会修改 GitHub PR 元数据。它绝不会合并、启用自动合并、将 PR 加入队列、修改无关提交或暂存无关工作。它绝不会根据近期活动发现工作，也不会隐式创建 Issue 或 Project。

调用

/woostack-commit [message]
/woostack-commit --no-pr-update [message]
/woostack-commit --issue <issue> [--issue <issue> ...] [message]

message 为可选参数。提供的消息若不准确，会被修正，而非照办。

--issue 接受 Issue 编号、Issue URL，或请求中及既定任务上下文中已明确指出的 Issue；每交付涉及一个相关 Issue，就重复一次。它只是简写形式，不是必需的输入格式；它绝不会决定要处理的工作：关联之前，先确认实际仓库和 Issue；若身份或意图确实模糊，则应询问。分支文本、PR 文本、标题、Issue key 和搜索结果都只是依据，不构成授权。Issue 上下文本身不授予发布权限；也绝不会仅因任务提到了子项，就选择其父项。

工作流

  1. 检查并准备。 在工作树内的任意目录中，Git 都能解析检查状态；无需位于特定位置。按照交付 准备和验证流程操作：检查分支、 预期基线、暂存区和差异，根据已授权的结果对变更进行分类；对于未解决的冲突、分离头状态、 此工作树上存在其他写入者、受保护的主分支工作，或确实无法分类的变更路径，应停止操作。只有在根据 证据仍然适用的条件独立评估现有工作者结果、 交接、计划或验证摘要的适用性后，才可复用其中已观察到的结果；对于耗时检查、缺少能力、超时及 其他未经验证的要求，按照 慢速检查处理。无论是否复用测试结果， 只要必需的钩子和已配置的 commit.command 非空，就必须运行。未解决的必需提交检查失败或超出范围的 修正都会阻止提交；绝不可跳过必需检查或弱化断言。缺少实现验收仍视为未满足，但不会阻止已授权的 草稿，除非它明确是提交或发布的门槛。须披露未满足的标准。对于仅涉及元数据的维护或 就绪状态，如果无需更改引用，则复用现有提交，并跳过准备、暂存、提交和推送。

  2. 暂存并提交。 按照交付 选择并提交流程操作：暂存明确指定的路径或 代码块，保持用户无关的已暂存和未暂存工作不变，并且只提交经过审查的选定内容。不得要求新增文件、 架构、回执、哈希清单或缓存子系统。

  3. 按需发布。 使用 --no-pr-update 时，到此为止：不推送、不创建 PR、不操作堆栈或议题， 也无需读取远程信息。保留已知的 PR 证据，但不要声称执行了实际上未进行的读取；应将远程身份报告为 未经验证，而不是声称其不存在或已成功交付。否则，按照交付 发布并回读流程操作：发布任务分支，复用匹配的开放 PR 或创建新的草稿 PR，遵循标题、正文、议题引用和请求备注的规则；只有在请求或仓库工作流要求时， 才登记原生堆栈成员关系。重写需要明确的维护范围。

  4. 验证交付。 亲自确认流程要求的回读结果：已发布的引用是预期的头部，PR 是预期的 PR 且使用了 预期的基线，标题和正文也与所写内容一致。除非请求变更，否则保留现有就绪状态。重新检查每个发生 变更或仍不确定的步骤；只读取作出该决定所需的信息。发生结果未知的写入后，查明实际发生的情况， 并从第一个尚未证实的步骤继续。绝不可因为响应丢失而重复提交、推送、更新 PR、添加堆栈链接或发表评论。

请求的 PR 维护与就绪状态

明确提出的已发布 PR 变基／重排请求，授权在指定范围内重写、发布、更改基分支并通过原生操作协调成员关系；仅请求就绪状态的操作无需新提交。普通提交和评论更正并不授权重排无关 PR；仅请求重排也不授权更改就绪状态。根据证据确定选定的 PR、预期的自底向上顺序、分支头、基分支和受影响的堆叠成员；写入前说明范围和顺序。只针对尚未解决且会产生实质影响的选择或连带影响提问，不要要求再次提交一套审批材料。

确保原始分支头可恢复、每个 PR 的身份及预期更改保持不变，并且未选中的分支、成员和本地编辑不受影响。遵循指定范围的租约保障和受支持的原生成员操作。现有成员关系和非顶层父项需要规划，而非拒绝；写入前解决对未选中成员产生的任何整栈影响。重新读取不完整或不确定的结果；如确有提供方或权限限制，则予以说明。

检查每个完整 PR 相对于其预期基分支的差异，以及整个堆叠相对于主干的合并差异：保留前置更改，不包含无关提交，也不丢弃已有工作。回读分支头、基分支、原生顺序／成员关系及请求的就绪状态；在新分支头上刷新检查。新 PR 默认设为草稿；未收到请求时，现有就绪状态保持不变。标记为就绪并不表示检查已通过，也不授予批准或合并权限。维护过程中绝不更改保护设置、凭据或既定策略。

报告

报告提交主题和 SHA、规范 PR URL 或明确说明仅在本地完成、实际观察到的验证结果，以及任何尚未解决的工作。只有在有助于审查或后续处理时，才补充分支、路径、堆叠或备注详情。绝不声称存在未经独立回读确认的提交、远程写入、检查或引用。

评论

支持 Markdown