Skip to content

Releases: liubowyf/spec-nfc-cli

Release list

v3.2.2

v3.2.2 Latest
Latest

Choose a tag to compare

View all tags
@liubowyf liubowyf released this 24 Apr 03:09
v3.2.2
8b93cc2

v3.2.2

本版本是 v3.2.x 的补丁发布，重点修复 clarify / design 阶段“AI 自动生成结论但未经过用户确认”的门禁缺口，确保团队协作流程真正遵循“先澄清、先确认，再进入执行”。

核心变化

  • change check --json 新增 confirmationStatus：
    • requirements：需求当前选择是否已确认；
    • technicalDesign：技术选型结论是否已确认；
    • executeReady：是否允许进入执行阶段；
    • blocking：确认缺失导致的阻断项。
  • status / doctor 继承 active change 的确认状态，让人和 AI Agent 都能看到待确认项。
  • specnfc change stage --to execute / in-progress 增加硬门禁：
    • 需求当前选择未确认时，不允许进入执行；
    • 中高复杂度 / 需要技术设计时，技术选型结论未确认也不允许进入执行。
  • human 输出增加“确认状态”摘要。
  • 中文 workflow skill 与 change 帮助文档同步补充确认门禁说明。
  • 新增回归测试覆盖未确认需求、未确认技术选型、未确认禁止进入 execute 与 JSON schema 契约。

安装 / 升级

npm install -g spec-nfc@3.2.2
specnfc version --json

验证

本次发布前已通过：

  • git diff --check
  • npm test
  • npm run test:release
  • node ./scripts/release.mjs --dry-run --strict --json
  • node ./scripts/release.mjs --strict --json

注意

本版本不再附带 tar/zip 安装包，统一通过 npm 分发。

Assets 2
Loading

v3.2.1

v3.2.1

Choose a tag to compare

View all tags
@liubowyf liubowyf released this 23 Apr 09:37
v3.2.1
290a82a

版本概览

v3.2.1 是面向 GitHub 公开发布与 npm 分发收口的版本，重点完成公开边界清理、npm-only 发布链路、公开样例补齐，以及 V3 协议控制面的关键 schema / 示例 / 测试冻结。

重点更新

1. 公开发布链路重构

  • 发布链路改为 npm-only，不再依赖 tar/zip 发布包
  • 新增公开装配脚本与发布校验脚本，发布前会自动生成 GitHub 源码视图与 npm 发布视图
  • release 支持 fast / strict / full-test 多档验证模式

2. 包内容与公开边界收敛

  • 通过 files 白名单显著缩小 npm 包体积
  • 增加公开边界校验，阻断内部路径、敏感内容与错误资产进入 npm 包
  • docs/ 从 GitHub 跟踪中移除，仅保留公开结果资产

3. V3 控制面资产冻结

  • 补齐 .specnfc/design/*.schema.json 输出合同与治理 schema
  • 补齐 .nfc/specs/* 运行时模型、技能分类、写回规则、遗留运行时迁移说明
  • 冻结 skill-packs/specnfc-zh-cn-default/manifest.json

4. 公共样例与模板增强

  • 补齐 specs/public-samples/*、examples/public/*
  • 完善 core/context/execution/governance/delivery/design/integration/quality 模板 manifest
  • 更新入口模板与 change / integration 模板元数据

5. 回归测试增强

  • 新增 CLI、治理记录、公开边界、投影与 skill-pack、验证回归等测试
  • 当前版本发布前已通过：
    • npm run test:release
    • npm test

安装

npm install -g spec-nfc

安装后可执行：

specnfc version --json
specnfc init --profile enterprise
specnfc doctor

说明

  • GitHub 仓库只发布公开结果，不包含团队内部过程文档
  • npm 是后续唯一正式安装渠道
Loading

v3.2.0

v3.2.0

Choose a tag to compare

View all tags
@liubowyf liubowyf released this 21 Apr 01:01
v3.2.0
a581de7

版本概述

v3.2.0 是当前公开稳定版本，完成了 spec-nfc 的 GitHub 公共仓与 npm 公共分发收口，并进一步补强了开源项目首屏说明、版本记录与示例引导。

这个版本的重点不是单点命令堆叠，而是把 specnfc 作为一个可直接用于团队协作与 AI Agent 协作的 Spec-driven Coding 协议系统 对外完整呈现。

本版本重点能力

1. 项目级协议接入

  • 支持通过 specnfc init 将普通仓接入统一协议
  • 初始化后形成 .specnfc/、.nfc/、specs/ 三层结构
  • 支持多工具入口投影：AGENTS.md、CLAUDE.md、.trae/rules/project_rules.md、opencode.json

2. change / integration 协作对象

  • change 用于管理需求、设计、技术选型、计划、执行、验收与归档
  • integration 用于管理多人接口 / service 对接、联调、阻断与状态对齐
  • status 与 doctor 分别负责下一步建议与协议一致性检查

3. 中文 skill-pack 与阶段化协作

  • 内置中文 workflow / support skill-pack
  • 支持围绕 clarify → design → plan → execute → verify → accept → archive 推进 change
  • 支持在仓内形成可持续维护的文档合同、阶段机与下一步协议

4. 公开发布与安装体验

  • GitHub 公共仓已完成公开化收口
  • npm 包已可直接安装与试用：
npm install -g spec-nfc
specnfc --help

# 或
npx --yes spec-nfc@latest --help

5. 开源项目可读性增强

  • README 重构为更适合 GitHub 首页阅读的结构
  • 默认中文 README，并补充独立英文 README
  • 增加 CHANGELOG.md 与 Releases 入口
  • 示例区收敛为 init → change → integration → demo 的推荐阅读路径

仓库命名说明

  • GitHub 仓库名现为：spec-nfc-cli
  • npm 包名保持：spec-nfc
  • CLI 命令保持：specnfc

适用场景

  • 希望把需求、设计、开发、测试、交付收口为仓内协议的团队
  • 希望让 Codex、Claude Code、Trae、OpenCode 等不同工具在同一项目下按同一规则协作
  • 希望把项目记忆、关键决策、阶段状态沉淀在仓内，而不是依赖单次聊天上下文

安装

全局安装

npm install -g spec-nfc
specnfc version
specnfc --help

直接试用

npx --yes spec-nfc@latest version
npx --yes spec-nfc@latest --help

相关入口

Loading