需要创建或更新 Spec Kit 项目章程时：解析模板…

适用于已有 .specify/ 目录的 Spec Kit 项目，需要根据用户输入或仓库上下文创建/更新 .specify/memory/constitution.md 时。

适用场景

解决思路

1. 开始处理前必须阅读并考虑用户输入 `$ARGUMENTS`（若非空）。
2. 执行范围守卫：将用户输入每一部分分类为章程内容或独立的非治理意图。
3. 如果输入包含功能实现、代码生成、重构、构建或部署请求，绝不能执行；将其提取为 deferred intents。
4. 绝不能创建、修改或删除应用源代码、功能路由、组件、测试、部署文件或与章程工作流无关的其他产物。
5. 如果不确定某指令是否属于章程内容，先请求澄清再修改。
6. 完成章程更新后，为每个 deferred intent 包含 `Next Actions` 区段：列出原始意图并建议合适的后续 Spec Kit 命令（如 `/speckit-specify`），但不要调用它。
7. 如果没有非治理意图，省略 `Next Actions` 区段。
8. 执行前检查扩展钩子：检查项目根目录是否存在 `.specify/extensions.yml`。
9. 如果存在，读取它并查找 `hooks.before_constitution` 键下的条目。
10. 如果 YAML 无法解析或无效，不要静默跳过：告诉用户 `.specify/extensions.yml` 无法读取（包含解析器错误），说明未检查任何钩子（包括其中注册的强制 `optional: false` 钩子），然后正常继续。
11. 过滤掉 `enabled` 显式为 `false` 的钩子；没有 `enabled` 字段的钩子默认视为启用。
12. 对每个剩余钩子，不要尝试解释或求值 hook 的 `condition` 表达式：如果钩子没有 `condition` 字段，或其为 null/空，视为可执行；如果定义了非空 `condition`，跳过该钩子，把条件求值留给 HookExecutor 实现。
13. 从 hook command 名称构造命令调用时，把点号 `.` 替换为连字符 `-`，例如 `speckit.git.commit` → `/speckit-git-commit`。
14. 对每个可执行钩子，根据其 `optional` 标志输出：可选钩子（`optional: true`）输出 `## Extension Hooks`、`**Optional Pre-Hook**: {extension}`、`Command: /{command}`、`Description: {description}`、`Prompt: {prompt}`、`To execute: /{command}`。
15. 对强制钩子（`optional: false`）输出 `## Extension Hooks`、`**Automatic Pre-Hook**: {extension}`、`Executing: /{command}`、`EXECUTE_COMMAND: {command}`，并等待钩子命令结果后再继续到 Outline。
16. 输出上述块后必须实际调用该钩子并等待其完成再继续；按当前 agent/session 中运行命令的相同方式运行它（例如 skills-mode agent 使用 `/skill:speckit-...` 或 `$speckit-...`）；只输出块不会运行钩子。
17. 如果没有注册钩子或 `.specify/extensions.yml` 不存在，静默跳过。
18. Outline 目标：更新 `.specify/memory/constitution.md`；活动章程脚手架在命令执行时通过 Spec Kit preset/template 解析栈从 `constitution-template` 解析。
19. 从仓库根目录运行 `.specify/scripts/bash/resolve-template.sh constitution-template --json`，解析 `TEMPLATE_CONTENT` 作为活动模板；共享解析器在核心模板回退前应用项目覆盖、组合 preset 层和 extension 层；它必须成功才能继续。
20. 如果模板解析失败，停止并报告解析错误；不要只用一个贡献模板层继续。
21. 如果 `.specify/memory/constitution.md` 存在，加载它作为当前项目特定值和修订的来源；在应用新解析出的脚手架时保留仍适用的信息。
22. 如果不存在，使用解析出的模板作为初始文档。
23. 不要把内容写回任何版本化模板层。
24. 识别所有形如 `[ALL_CAPS_IDENTIFIER]` 的占位符 token；用户可能需要比模板更少或更多的原则，如果指定了数量就遵守该数量，同时遵循通用模板并相应更新文档。
25. 收集/推导占位符值：如果用户输入（对话）提供了值，使用它。
26. 否则从现有仓库上下文（README、docs、先前章程版本，如果嵌入其中）推断。
27. 治理日期：`RATIFICATION_DATE` 是原始采用日期（如果未知则询问或标记 TODO）；`LAST_AMENDED_DATE` 如果有变更则为今天，否则保持之前值。
28. `CONSTITUTION_VERSION` 必须按语义化版本规则递增：MAJOR 为向后不兼容的治理/原则移除或重定义；MINOR 为新增原则/章节或实质性扩展指导；PATCH 为澄清、措辞、拼写修复、非语义细化。
29. 如果版本递增类型有歧义，在最终确定前提出理由。
30. 使用解析出的模板作为必需结构起草更新后的章程内容：用具体文本替换每个占位符（除项目选择尚未定义、且明确说明理由的故意保留模板槽位外，不留下括号 token）。
31. 保留标题层级；一旦替换完成，可以移除注释，除非注释仍提供澄清指导。
32. 确保每个 Principle 章节：简洁名称行、段落（或项目符号列表）捕获不可协商规则、若不明显则给出明确理由。
33. 确保 Governance 章节列出修订程序、版本策略和合规审查期望。
34. 更新后，在章程文件顶部生成 Sync Impact Report 作为 HTML 注释；该报告是供人工审查修订的临时草稿材料，不是治理内容，预期在提交修订后的章程文件前移除。
35. Sync Impact Report 包含：版本变更 old → new；修改的原则列表（旧标题 → 新标题，如重命名）；新增章节；移除章节；如有故意延期的占位符，列出后续 TODO。
36. 最终输出前验证：没有仍未解释的括号 token。
37. 验证版本行与报告一致。
38. 验证日期为 ISO 格式 YYYY-MM-DD。
39. 验证原则是声明式、可测试、无模糊语言（酌情把「should」替换为 MUST/SHOULD 及理由）。
40. 将完成后的章程写回 `.specify/memory/constitution.md`（覆盖）。
41. 向用户输出最终摘要，包含：新版本和递增理由；任何需要人工跟进的 TODO 占位符或延期项；建议提交信息（例如 `docs: amend constitution to vX.Y.Z (principle additions + governance update)`）；针对任何 deferred 非治理意图的 `Next Actions` 区段。
42. 格式与风格要求：Markdown 标题与模板完全一致（不要降级/升级层级）。
43. 换行长理由行以保持可读性（理想 <100 字符），但不要用尴尬断行硬性强制。
44. 章节之间保留单个空行。
45. 避免行尾空白。
46. 如果用户提供部分更新（例如仅修订一个原则），仍然执行验证和版本决策步骤。
47. 如果缺少关键信息（例如批准日期确实未知），插入 `TODO(<FIELD_NAME>): explanation` 并将其列入 Sync Impact Report 的 deferred 项。
48. 只写 `.specify/memory/constitution.md`；不要创建或修改模板源文件。
49. 执行后检查扩展钩子：检查项目根目录是否存在 `.specify/extensions.yml`。
50. 如果存在，读取并查找 `hooks.after_constitution` 键下的条目。
51. 如果 YAML 无法解析或无效，不要静默跳过：告诉用户 `.specify/extensions.yml` 无法读取（包含解析器错误），说明未检查任何钩子（包括其中注册的强制 `optional: false` 钩子），然后正常继续。
52. 过滤掉 `enabled` 显式为 `false` 的钩子；没有 `enabled` 字段的钩子默认视为启用。
53. 对每个剩余钩子，不要尝试解释或求值 hook 的 `condition` 表达式：如果钩子没有 `condition` 字段，或其为 null/空，视为可执行；如果定义了非空 `condition`，跳过该钩子，把条件求值留给 HookExecutor 实现。
54. 从 hook command 名称构造命令调用时，把点号 `.` 替换为连字符 `-`，例如 `speckit.git.commit` → `/speckit-git-commit`。
55. 对每个可执行钩子，根据 `optional` 标志输出：可选钩子（`optional: true`）输出 `## Extension Hooks`、`**Optional Hook**: {extension}`、`Command: /{command}`、`Description: {description}`、`Prompt: {prompt}`、`To execute: /{command}`。
56. 对强制钩子（`optional: false`）输出 `## Extension Hooks`、`**Automatic Hook**: {extension}`、`Executing: /{command}`、`EXECUTE_COMMAND: {command}`。
57. 输出上述块后必须实际调用该钩子并等待其完成再继续；按当前 agent/session 中运行命令的相同方式运行它（例如 skills-mode agent 使用 `/skill:speckit-...` 或 `$speckit-...`）；只输出块不会运行钩子。
58. 如果没有注册钩子或 `.specify/extensions.yml` 不存在，静默跳过。

适用边界 · 注意事项

• 项目没有 Spec Kit 结构（缺少 `.specify/` 目录、`resolve-template.sh` 或模板解析栈）时，不要使用。
• 用户请求的是功能实现、代码生成、重构、构建、部署等非治理任务时，不要在本流程中执行；应作为 deferred intent 转交相应 Spec Kit 命令。
• 只想修改版本化模板层、应用源码或其他非 `.specify/memory/constitution.md` 文件时，不要使用。