用户输入
$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):
发出上述块后,你必须实际调用钩子并等待其完成,然后再继续。以你在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的 literal## 扩展钩子 **自动前置钩子**:{extension} 正在执行:`/{command}` EXECUTE_COMMAND:{command} 在继续大纲之前等待钩子命令的结果。{command}id 不同,例如,skills-mode 代理将其作为/skill:speckit-...或$speckit-...运行)。仅发出块不会运行钩子。
- 可选钩子(
- 如果没有注册钩子或
.specify/extensions.yml不存在,则静默跳过。
大纲
你正在更新位于 .specify/memory/constitution.md 的项目章程。活动的章程脚手架在命令执行时通过 Spec Kit 预设/模板解析栈从 constitution-template 解析而来。
遵循以下执行流程:
-
从仓库根目录运行
.specify/scripts/bash/resolve-template.sh constitution-template --json,并将TEMPLATE_CONTENT解析为活动模板。- 共享解析器应用项目覆盖,组合预设层和扩展层,最后回退到核心模板。必须成功才能继续。
- 如果失败,则停止并报告解析错误;不要仅用一个贡献的模板层继续。
- 如果
.specify/memory/constitution.md存在,将其加载为当前项目特定值和修正的来源。在应用新解析的脚手架时,保留仍然适用的信息。 - 如果不存在,则使用解析后的模板作为初始文档。
- 不要写回任何版本化的模板层。
- 识别所有形式为
[ALL_CAPS_IDENTIFIER]的占位符令牌。 重要:用户可能需要的原则少于或多于模板中使用的原则。如果指定了数量,请尊重该数量 - 遵循通用模板。你将相应更新文档。
-
收集/推导占位符的值:
- 如果用户输入(对话)提供了值,则使用它。
- 否则从现有仓库上下文(README、文档、先前的章程版本(如果嵌入))推断。
- 对于治理日期:
RATIFICATION_DATE是原始采用日期(如果未知则询问或标记 TODO),LAST_AMENDED_DATE如果进行了更改则为今天,否则保留先前的值。 CONSTITUTION_VERSION必须根据语义版本控制规则递增:- MAJOR:向后不兼容的治理/原则移除或重新定义。
- MINOR:新增原则/部分或材料性扩展指导。
- PATCH:澄清、措辞、拼写错误修复、非语义改进。
- 如果版本升级类型不明确,在最终确定前提出推理。
-
使用解析后的模板作为所需结构起草更新的章程内容:
- 用具体文本替换每个占位符(没有留括号的令牌,除非项目选择尚未定义的故意保留的模板槽 - 明确证明任何保留的合理性)。
- 保留标题层次,注释可以在替换后移除,除非它们仍然提供澄清指导。
- 确保每个原则部分:简洁的名称行、段落(或项目符号列表)捕获不可协商的规则、如果不明显则明确说明理由。
- 确保治理部分列出修改程序、版本控制策略和合规性审查期望。
-
更新后在章程文件顶部生成同步影响报告作为 HTML 注释。 此报告是供人工审查修正的临时草稿材料,不是治理内容;预计在修订后的章程文件提交前将其移除。
- 版本变更:旧 → 新。
- 修改的原则列表(如果重命名则显示旧标题 → 新标题)。
- 新增部分。
- 移除部分。
- 后续待办事项(如果有意推迟的占位符)。
-
最终输出前的验证:
- 没有剩余未解释的括号令牌。
- 版本行与报告匹配。
- 日期为 ISO 格式 YYYY-MM-DD。
- 原则是声明性的、可测试的,并且没有模糊的语言(将“应该”替换为 MUST/SHOULD 的理由(如果合适))。
-
将完成的章程写回
.specify/memory/constitution.md(覆盖)。 -
向用户输出最终摘要,包括:
- 新版本和版本升级理由。
- 任何 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):
发出上述块后,你必须实际调用钩子并等待其完成,然后再继续。以你在此代理/会话中运行命令的相同方式运行它(调用方式可能与上面显示的 literal## 扩展钩子 **自动钩子**:{extension} 正在执行:`/{command}` EXECUTE_COMMAND:{command}{command}id 不同,例如,skills-mode 代理将其作为/skill:speckit-...或$speckit-...运行)。仅发出块不会运行钩子。
- 可选钩子(
- 如果没有注册钩子或
.specify/extensions.yml不存在,则静默跳过。