Communitygithub.com

项目章程更新器

根据交互式或提供的原则输入,创建或更新项目章程文件。

项目章程更新器 是什么?

该技能专注于更新项目章程(通常位于 `.specify/memory/constitution.md`)。它从用户输入中提取治理内容,过滤掉非治理意图(如功能实现、代码生成),并自动解析模板占位符(如 `RATIFICATION_DATE`、`CONSTITUTION_VERSION`)。技能支持前后扩展钩子(通过 `.specify/extensions.yml` 配置),允许在更新前后执行可选或强制命令。它遵循严格的语义版本控制规则,生成同步影响报告(HTML 注释),并输出带有版本变更、待办事项和推提交信息的摘要。适用于 Claude Code、Cursor 等 AI 代理平台,确保障书更新过程的完整性和可审计性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangjuyo/reels-blocker/tree/HEAD/.claude/skills/speckit-constitution

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

用户输入

$ARGUMENTS

在继续之前,你必须考虑用户输入(如果非空)。

范围守卫

此命令自身的工作仅限于更新项目章程。依赖的模板和命令在运行时读取章程,此处不进行修改。

  • 将用户输入的每一部分分类为章程内容或独立的非治理意图。
  • 如果输入包含功能实现、代码生成、重构、构建或部署请求,你不得执行它们。而是将其提取为延迟意图。
  • 你不得创建、修改或删除与章程工作流无关的应用源文件、功能路由、组件、测试、部署文件或其他工件。
  • 如果不清楚某条指令是否为章程内容,请在做出更改前要求澄清。
  • 完成章程更新后,为每个延迟意图包含一个“下一步操作”部分。列出原始意图并建议适当的后续 Spec Kit 命令,如 /speckit-specify,但不实际调用。
  • 如果没有非治理意图,则省略“下一步操作”部分。

执行前检查

检查扩展钩子(在章程更新前):

  • 检查项目根目录下是否存在 .specify/extensions.yml。
  • 如果存在,读取它并查找 hooks.before_constitution 键下的条目。
  • 如果 YAML 无法解析或无效,不要静默跳过:告知用户 .specify/extensions.yml 无法读取(包括解析器错误),并且没有检查任何钩子,包括其中注册的任何强制(optional: false)钩子,然后继续正常流程。
  • 过滤掉 enabled 显式为 false 的钩子。将没有 enabled 字段的钩子视为默认启用。
  • 对于每个剩余的钩子,不要尝试解释或评估钩子的 condition 表达式:
    • 如果钩子没有 condition 字段,或者它为 null/空,则将钩子视为可执行。
    • 如果钩子定义了非空的 condition,则跳过此钩子,将条件评估留给 HookExecutor 实现。
  • 从钩子命令名称构造命令调用时,将点号(.)替换为连字符(-)。例如,speckit.git.commit → /speckit-git-commit。
  • 对于每个可执行的钩子,根据其 optional 标志输出以下内容:
    • 可选钩子(optional: true):
      ## 扩展钩子
      
      **可选前置钩子**:{extension}
      命令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      要执行:`/{command}`
      
    • 强制钩子(optional: false):
      ## 扩展钩子
      
      **自动前置钩子**:{extension}
      正在执行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      在继续大纲之前等待钩子命令的结果。
      
      发出上述块后,你必须实际调用钩子并等待其完成,然后再继续。以你在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的 literal {command} id 不同,例如,skills-mode 代理将其作为 /skill:speckit-... 或 $speckit-... 运行)。仅发出块不会运行钩子。
  • 如果没有注册钩子或 .specify/extensions.yml 不存在,则静默跳过。

大纲

你正在更新位于 .specify/memory/constitution.md 的项目章程。活动的章程脚手架在命令执行时通过 Spec Kit 预设/模板解析栈从 constitution-template 解析而来。

遵循以下执行流程:

  1. 从仓库根目录运行 .specify/scripts/bash/resolve-template.sh constitution-template --json,并将 TEMPLATE_CONTENT 解析为活动模板。

    • 共享解析器应用项目覆盖,组合预设层和扩展层,最后回退到核心模板。必须成功才能继续。
    • 如果失败,则停止并报告解析错误;不要仅用一个贡献的模板层继续。
    • 如果 .specify/memory/constitution.md 存在,将其加载为当前项目特定值和修正的来源。在应用新解析的脚手架时,保留仍然适用的信息。
    • 如果不存在,则使用解析后的模板作为初始文档。
    • 不要写回任何版本化的模板层。
    • 识别所有形式为 [ALL_CAPS_IDENTIFIER] 的占位符令牌。 重要:用户可能需要的原则少于或多于模板中使用的原则。如果指定了数量,请尊重该数量 - 遵循通用模板。你将相应更新文档。
  2. 收集/推导占位符的值:

    • 如果用户输入(对话)提供了值,则使用它。
    • 否则从现有仓库上下文(README、文档、先前的章程版本(如果嵌入))推断。
    • 对于治理日期:RATIFICATION_DATE 是原始采用日期(如果未知则询问或标记 TODO),LAST_AMENDED_DATE 如果进行了更改则为今天,否则保留先前的值。
    • CONSTITUTION_VERSION 必须根据语义版本控制规则递增:
      • MAJOR:向后不兼容的治理/原则移除或重新定义。
      • MINOR:新增原则/部分或材料性扩展指导。
      • PATCH:澄清、措辞、拼写错误修复、非语义改进。
    • 如果版本升级类型不明确,在最终确定前提出推理。
  3. 使用解析后的模板作为所需结构起草更新的章程内容:

    • 用具体文本替换每个占位符(没有留括号的令牌,除非项目选择尚未定义的故意保留的模板槽 - 明确证明任何保留的合理性)。
    • 保留标题层次,注释可以在替换后移除,除非它们仍然提供澄清指导。
    • 确保每个原则部分:简洁的名称行、段落(或项目符号列表)捕获不可协商的规则、如果不明显则明确说明理由。
    • 确保治理部分列出修改程序、版本控制策略和合规性审查期望。
  4. 更新后在章程文件顶部生成同步影响报告作为 HTML 注释。 此报告是供人工审查修正的临时草稿材料,不是治理内容;预计在修订后的章程文件提交前将其移除。

    • 版本变更:旧 → 新。
    • 修改的原则列表(如果重命名则显示旧标题 → 新标题)。
    • 新增部分。
    • 移除部分。
    • 后续待办事项(如果有意推迟的占位符)。
  5. 最终输出前的验证:

    • 没有剩余未解释的括号令牌。
    • 版本行与报告匹配。
    • 日期为 ISO 格式 YYYY-MM-DD。
    • 原则是声明性的、可测试的,并且没有模糊的语言(将“应该”替换为 MUST/SHOULD 的理由(如果合适))。
  6. 将完成的章程写回 .specify/memory/constitution.md(覆盖)。

  7. 向用户输出最终摘要,包括:

    • 新版本和版本升级理由。
    • 任何 TODO 占位符或需要人工跟进的延迟项。
    • 建议的提交信息(例如,docs: 修改章程至 vX.Y.Z(原则添加 + 治理更新))。
    • 针对任何延迟的非治理意图的“下一步操作”部分。

格式与样式要求:

  • 使用与模板完全相同的 Markdown 标题(不要降低/提升级别)。
  • 将较长的理由行换行以保持可读性(理想情况下 <100 字符),但不要用尴尬的断行强制实施。
  • 各部分之间保留一个空行。
  • 避免尾随空格。

如果用户提供部分更新(例如,仅一条原则修订),仍然执行验证和版本决策步骤。

如果关键信息缺失(例如,批准日期确实未知),插入 TODO(<FIELD_NAME>):说明 并将其包含在同步影响报告的延迟项下。

只写 .specify/memory/constitution.md;不要创建或修改模板源文件。

执行后检查

检查扩展钩子(在章程更新后): 检查项目根目录下是否存在 .specify/extensions.yml。

  • 如果存在,读取它并查找 hooks.after_constitution 键下的条目。
  • 如果 YAML 无法解析或无效,不要静默跳过:告知用户 .specify/extensions.yml 无法读取(包括解析器错误),并且没有检查任何钩子,包括其中注册的任何强制(optional: false)钩子,然后继续正常流程。
  • 过滤掉 enabled 显式为 false 的钩子。将没有 enabled 字段的钩子视为默认启用。
  • 对于每个剩余的钩子,不要尝试解释或评估钩子的 condition 表达式:
    • 如果钩子没有 condition 字段,或者它为 null/空,则将钩子视为可执行。
    • 如果钩子定义了非空的 condition,则跳过此钩子,将条件评估留给 HookExecutor 实现。
  • 从钩子命令名称构造命令调用时,将点号(.)替换为连字符(-)。例如,speckit.git.commit → /speckit-git-commit。
  • 对于每个可执行的钩子,根据其 optional 标志输出以下内容:
    • 可选钩子(optional: true):
      ## 扩展钩子
      
      **可选钩子**:{extension}
      命令:`/{command}`
      描述:{description}
      
      提示:{prompt}
      要执行:`/{command}`
      
    • 强制钩子(optional: false):
      ## 扩展钩子
      
      **自动钩子**:{extension}
      正在执行:`/{command}`
      EXECUTE_COMMAND:{command}
      
      发出上述块后,你必须实际调用钩子并等待其完成,然后再继续。以你在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的 literal {command} id 不同,例如,skills-mode 代理将其作为 /skill:speckit-... 或 $speckit-... 运行)。仅发出块不会运行钩子。
  • 如果没有注册钩子或 .specify/extensions.yml 不存在,则静默跳过。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

相关技能