메뉴
根据代码变更反向更新 OpenSpec 四个工件（proposal/design/specs/tasks）。当用户说"反向更新spec"、"反向更新工件"、"我自己修改了代码，更新下spec文档"时使用此技能。支持无输入（分析 Git 变更）或指定文件路径。输出更新建议后必须询问用户确认再执行更新。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | openspec-reverse-update-spec |
| description | 根据代码变更反向更新 OpenSpec 四个工件（proposal/design/specs/tasks）。当用户说"反向更新spec"、"反向更新工件"、"我自己修改了代码，更新下spec文档"时使用此技能。支持无输入（分析 Git 变更）或指定文件路径。输出更新建议后必须询问用户确认再执行更新。 |
| metadata | {"author":"Kinney Yan","version":"1.0"} |
根据代码变更或指定文件反向更新 OpenSpec 四个工件（artifacts）。
# no params
/openspec-reverse-update-spec
# single path
/openspec-reverse-update-spec src/components/checkout-form.tsx
# multiple paths
/openspec-reverse-update-spec src/api/payment.ts src/components/checkout-form.tsx
Copy this checklist and check off items as you complete them:
- [ ] Step 1: 获取 OpenSpec 概念定义
- [ ] Step 2: 确定分析范围
- [ ] Step 3: 定位对应的 Change
- [ ] Step 4: 分析代码变更
- [ ] Step 5: 评估四个工件的更新需求
- [ ] Step 6: 输出更新建议
- [ ] Step 7: 询问用户并执行更新
在开始分析前，必须校验自己对 OpenSpec 四个工件（artifacts）最新定义的理解：
curl -m 10 -s https://raw.githubusercontent.com/Fission-AI/OpenSpec/refs/heads/main/docs/concepts.md
理解核心流转逻辑：Proposal (Why) -> Specs (What) -> Design (How) -> Tasks (Steps)。
如果有文件路径输入：分析用户指定的文件。
如果没有输入：分析当前仓库的 Git 变更（暂存区 + 工作区）：
git diff HEAD
在 openspec/changes/ 目录下（优先搜索活跃目录，次选 openspec/changes/archive/ 归档目录）寻找与代码变更最匹配的 Change：
匹配标准：
design.md 中 "File Changes" 列表匹配。proposal.md 描述的意图一致。specs/ 下的目录结构对应。注意
对每个变更的文件，分析：
分析维度：
基于 Step 1 的核心原则，分析代码变更（Diff）并决定更新内容：
| 工件 | 更新触发条件 (基于代码实际实现) | 核心操作 |
|---|---|---|
| Proposal | 实际实现范围(Scope)或方法(Approach)与原计划有显著偏离 | 修正 Intent/Scope/Approach |
| Specs | 引入了新行为、修改了现有逻辑或删除了功能 | 按 Delta 格式 编写需求 |
| Design | 实际选用的技术方案、架构决策或文件路径与原设计不符 | 更新技术方案及 File Changes 列表 |
| Tasks | 任务已完成、发现遗漏步骤或顺序调整 | 勾选 [x] 或增删任务项 |
必须使用 ADDED/MODIFIED/REMOVED 结构描述行为变化，严禁记录内部实现细节：
## [ADDED/MODIFIED/REMOVED] Requirements
### Requirement: [名称]
[描述变更内容。如果是 MODIFIED，需注明 (Previously: ...)]
#### Scenario: [场景名]
- GIVEN...
- WHEN...
- THEN...
design.md 中的 File Changes 列表，反映实际新增、修改和删除的文件路径。tasks.md 的层级编号格式（如 1.1, 1.2），确保所有已完成的步骤均标记为 [x]。以结构化格式输出：
## 分析结果
**匹配的 Change**: `openspec/changes/[change-name]/` or `openspec/changes/archive/[change-name]/`
### 需要更新的工件
| 工件 | 是否需要更新 | 修改摘要 |
| ----------- | ------------ | ---------- |
| proposal.md | ✅/❌ | [简要说明] |
| specs/ | ✅/❌ | [简要说明] |
| design.md | ✅/❌ | [简要说明] |
| tasks.md | ✅/❌ | [简要说明] |
### 详细修改建议
#### proposal.md
[具体修改内容或"无需修改"]
#### specs/[domain]/spec.md
[具体的 delta spec 内容]
#### design.md
[具体修改内容]
#### tasks.md
[具体修改内容]
输出分析结果后，若没有需要更新的工件，则结束工作流。否则必须询问用户："以上是代码变更对应的工件更新建议。是否需要我现在帮您更新这些文件？"，选项：1. 是、2. 否、3. 指定只更新某些工件（如"只更新 specs"）
用户同意后，执行更新：
更新原则：
示例 1：无输入，分析 Git 变更
用户输入：
反向更新四个工件
你的操作：
git diff HEAD 获取所有变更openspec/changes/ 找到匹配的 change示例 2：指定文件路径
用户输入：
我自己修改了代码，更新下 spec 文档 src/auth/login.ts src/components/AuthForm.tsx
你的操作：
openspec/changes/ 中与 auth 相关的 change示例 3：用户只更新部分工件
用户：
反向更新spec
你：（输出分析结果）
以上是代码变更对应的工件更新建议。是否需要我现在帮您更新这些文件？
- 输入 "是"/"yes"/"更新" 开始更新
- 输入 "否"/"no" 仅保留建议
- 或者指定只更新某些工件（如"只更新 specs"）
用户：
只更新 specs
你：仅更新 openspec/changes/[change-name]/specs/ 下的 delta spec 文件
Reviews the changes, identifies critical and high-priority issues, generates review summaries, and collects metrics data for local use. Use this when users need to code review or analyzing code changes for quality issues.
Posts metrics data to a reporting endpoint. Use this when users need to send metrics data that has been collected and stored in temporary files to a reporting API.
Development patterns for ice.js 3 projects, covering page components (lists/forms), menu & permissions, API services, and state management. Use when creating or modifying pages, configuring routing/auth, or implementing data fetching in the ice.js 3 admin console.
Implement comprehensive testing strategies using Jest, Vitest, and Testing Library for unit tests, integration tests, and end-to-end testing with mocking, fixtures, and test-driven development. Use when writing JavaScript/TypeScript tests, setting up test infrastructure, or implementing TDD/BDD workflows.
Master ES6+ features including async/await, destructuring, spread operators, arrow functions, promises, modules, iterators, generators, and functional programming patterns for writing clean, efficient JavaScript code. Use when refactoring legacy code, implementing modern patterns, or optimizing JavaScript applications.
Master Next.js 14+ App Router with Server Components, streaming, parallel routes, and advanced data fetching. Use when building Next.js applications, implementing SSR/SSG, or optimizing React Server Components.