spec-commit ​

将当前改动整理为清晰 commit，并生成符合仓库风格的 commit message。

ASCII 链路图 ​

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
  |
  v
  spec-commit
  entry: internal_only
  type: internal-only

基本信息 ​

字段内容
Skillspec-commit
类型internal-only
研发链路位置Code
当前入口internal_only
兼容别名不适用
Sourceskills/spec-commit/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述 ​

Internal commit helper for public workflows that already hold explicit commit authorization; creates scoped, value-communicating commits without owning push or PR landing.

Source 契约摘要 ​

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用 ​

  • 用户明确要求 commit。
  • 一组验证完成的改动需要保存为提交。
  • 需要从 diff 提炼价值导向的提交说明。

工作步骤 ​

  • 读取 plan、task pack、bug report 或明确实现目标。
  • 建立小步任务列表，按现有代码模式做最小必要修改。
  • 运行聚焦验证、测试、构建、浏览器或平台检查。
  • 把 diff、验证结果和剩余风险交给 review 或 knowledge 阶段。

输出 ​

  • 实现 diff、测试结果、构建输出、浏览器截图或运行证据。
  • 必要时输出 blocked 原因，而不是扩大 scope。

Agent 调度 ​

  • 小任务通常 inline；大任务可按文件边界使用 serial 或 parallel workers。
  • 调试、优化、UI、平台专项可引入对应 specialist agents，但 orchestrator 负责最终集成。

本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。

边界 ​

  • 提交前必须遵守项目验证和变更检测规则。
  • 不应混入无关文件。

源码校准 ​

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
  • 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。