@localsummer/incspec 0.1.1 → 0.1.2

package/README.md

@@ -4,6 +4,7 @@
 <p align="center">面向 AI 编程助手的增量规范驱动开发工具</p>
 <p align="center">
   <a href="https://github.com/localSummer/IncSpec"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-localSummer%2FIncSpec-blue?style=flat-square&logo=github" /></a>
+  <a href="https://www.npmjs.com/package/@localsummer/incspec"><img alt="npm" src="https://img.shields.io/npm/v/@localsummer/incspec?style=flat-square&logo=npm" /></a>
   <a href="https://nodejs.org/"><img alt="node version" src="https://img.shields.io/node/v/@localsummer/incspec?style=flat-square" /></a>
   <a href="./LICENSE"><img alt="License: ISC" src="https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square" /></a>
 </p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localsummer/incspec",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "面向 AI 编程助手的增量规范驱动开发工具",
   "bin": {
     "incspec": "index.mjs"

package/templates/AGENTS.md

@@ -19,7 +19,7 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 - 检查状态: `incspec status`
 - 编号引用: `[S1]` 时序步骤, `[D1]` 依赖, `[C1]` 变更
 - 增量标记: `[N1]` 新增, `[S1-Modified]` 修改, `[S1-Deleted]` 删除
-- 继续前验证: `incspec validate --strict`
+- 验证时机: 步骤 1/4/6 完成后、归档前执行 `incspec validate`，出错时加 `--strict` 用于 CI
 
 ## 七步工作流
 
@@ -38,6 +38,8 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 **交付物**: Mermaid 时序图 (`[S1]`-`[Sn]`)、依赖图 (`[D1]`-`[Dn]`)、依赖摘要 (`[R1.x]`-`[R3.x]`)
 
+**验证**: 完成后执行 `incspec validate` 检查基线格式（必含时序图和依赖图）
+
 ### 步骤 2: 收集结构化需求
 
 **命令**: `incspec collect-req` (别名: `cr`)
@@ -75,6 +77,8 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 6. 潜在风险与副作用
 7. 建议的测试用例 (至少6个)
 
+**验证**: 完成后执行 `incspec validate` 检查增量格式（必含5个模块章节）
+
 ### 步骤 5: 应用代码变更
 
 **命令**: `incspec apply [increment-path]` (别名: `ap`)
@@ -93,12 +97,16 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 **处理**: 移除增量标记 → 合并新节点 → 重新编号为干净序列 → 输出新基线 v{n+1}
 
+**验证**: 完成后执行 `incspec validate` 检查新基线完整性
+
 ### 步骤 7: 归档工作流产出
 
 **命令**: `incspec archive [--yes] [<file>] [--keep]`
 
 **目的**: 将已完成的工作流产出归档到 `incspec/archives/YYYY-MM/{module}/`
 
+**验证**: 归档前执行 `incspec validate` 确保项目健康，归档后再次验证确保文件移动正确
+
 ## 目录结构
 
 ```

package/templates/inc-spec-skill/SKILL.md

@@ -100,7 +100,8 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 管理命令:
 - `incspec status` - 查看工作流状态
 - `incspec list` - 列出规范文件
-- `incspec validate` - 验证项目健康状态
+- `incspec validate` - 验证项目健康状态（步骤1/4/6后、归档前执行）
+- `incspec validate --strict` - 严格模式，有错误时退出码为1（用于CI）
 - `incspec reset` - 重置工作流到初始状态
 - `incspec reset --to=N` - 回退到步骤N，保留1-N，重置N+1至7（示例：`--to=3` 保留1-3，重置4-7）
 
@@ -123,6 +124,8 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 - 组件/Store依赖关系图
 - 数据流摘要
 
+**验证:** 完成后执行 `incspec validate` 检查基线格式（必含时序图和依赖图）
+
 详见 [references/analyze-codeflow.md](references/analyze-codeflow.md)。
 
 ### 步骤2: 需求收集
@@ -165,6 +168,8 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 - 文件修改计划 (新增/修改/删除)
 - 分步实现指导
 
+**验证:** 完成后执行 `incspec validate` 检查增量格式（必含5个模块章节）
+
 详见 [references/analyze-increment-codeflow.md](references/analyze-increment-codeflow.md)。
 
 ### 步骤5: 代码应用
@@ -188,6 +193,8 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 
 **输出:** 代表当前系统状态的干净基线(无增量标记)
 
+**验证:** 完成后执行 `incspec validate` 检查新基线完整性
+
 详见 [references/merge-to-baseline.md](references/merge-to-baseline.md)。
 
 ### 步骤7: 归档
@@ -203,6 +210,8 @@ incspec archive <file> --yes       # 归档指定文件
 incspec archive <file> --keep      # 复制而非移动
 ```
 
+**验证:** 归档前执行 `incspec validate` 确保项目健康，归档后再次验证确保文件移动正确
+
 详见 [references/inc-archive.md](references/inc-archive.md)。
 
 ## 最佳实践
@@ -220,10 +229,12 @@ incspec archive <file> --keep      # 复制而非移动
 - 仅在变更范围明确、不涉及复杂依赖时使用快速模式
 
 **验证节点:**
+- 步骤1后: `incspec validate` 检查基线格式（必含时序图和依赖图）
 - 步骤2后: 需求中无模糊术语
-- 步骤4后 (完整模式): 编码前审查蓝图
+- 步骤4后 (完整模式): `incspec validate` 检查增量格式 + 编码前审查蓝图
 - 步骤5后: 验证所有文件已正确创建/修改
-- 步骤7后: 确认工作区已清理
+- 步骤6后: `incspec validate` 检查新基线完整性
+- 步骤7前后: 归档前后各执行 `incspec validate` 确保项目健康
 
 **工作流重置:**
 - 完全重置: `incspec reset` - 归档所有产出，回到初始状态