新闻详情

新闻详情

首页 / 资讯中心 / 详情

用 Elsa Core 的 Feature Specification 模板编写高质量功能规格说明书

发布时间:2026/11/12 13:16:46来源:尧图网络
用 Elsa Core 的 Feature Specification 模板编写高质量功能规格说明书
后端工作流自动化流程编排低代码【免费下载链接】elsa-coreThe Workflow Engine for .NET项目地址https://gitcode.com/gh_mirrors/el/elsa-core点击查看免费下载本文以 elsa-core 仓库中.specify/templates/spec-template.md这一功能规格模板为骨架结合仓库内真实落地产物specs/013-user-tasks/spec.md与 Speckit 自动化工作流配置完整讲解如何编写一份可评审、可测试、可落地的 Feature Specification并说明它如何向下游的 implementation plan、tasks 清单与检查清单传导。读完本文你将掌握该模板每一节的填写要点、优先级与验收场景的写法以及它在仓库实际开发流程中的位置。模板在 Speckit 全流程中的位置.specify/templates/spec-template.md是 elsa-core 仓库中 SpeckitSpec Kit工具链的功能规格模板用于把一段自然语言的产品想法转化为结构化、可评审、可独立测试的功能规格说明书spec.md。从 workflow.yml 可以看到完整的 SDDSpec-Driven Development循环steps: - id: specify # speckit.specify → 生成 spec.md - id: review-spec # 人工评审 gatereject 则中止 - id: plan # speckit.plan → 生成 plan.md / research.md />**Feature Branch**: 013-user-tasks **Created**: 2026-08-17 **Status**: Approved for implementation仓库的init-options.json.specify/init-options.json显示当前项目以 codex 作为 AI 集成、使用 sequential 分支编号、以 AGENTS.md 作为上下文文件feature.json.specify/feature.json则把特性目录固定为specs/013-user-tasks——这解释了为什么specs/下每个特性001-shell-reload-api、002-graceful-shutdown……013-user-tasks都有一份遵循该模板的 spec.md。User Scenarios Testing以可独立测试的用户故事为 MVP 切片模板最强调的一节是User Scenarios Testing必填。其核心方法论写在注释中用户故事必须按重要性排序的用户旅程来编写并且每一条都必须可以独立测试——只实现其中一条也应当构成一个有价值的 MVP。模板给出的故事模板结构为标题 优先级P1 / P2 / P3P1 是最关键切片Why this priority解释该优先级背后的价值依据Independent Test用「可通过 [具体动作] 完整测试并交付 [具体价值]」句式描述独立验证方式Acceptance Scenarios用 Given / When / Then 三段式列出验收场景。对照真实案例 013-user-tasks/spec.md 的第 1 条用户故事### User Story 1 - Model and execute a user task (Priority: P1) **Independent Test**: Publish and run a workflow containing one User Task, complete it through REST, and verify the selected action and normalized form data resume the correct activity exactly once. **Acceptance Scenarios**: 1. **Given** a task with a direct assignee, **When** the activity executes, **Then** an Assigned task and matching bookmark are persisted and only the assignee or a manager can read protected content.可以看到模板中「Given…When…Then…」的占位符被替换成了可执行的验收标准状态变化、持久化约束、权限边界都写得可验证。真实 spec 还示范了 P1/P2 的合理分层——核心执行能力US1、任务收件箱US2、身份中性集成US3列为 P1外部门户完成US4与超时恢复US5列为 P2形成了明确的迭代路径。Edge Cases在写需求前先穷举边界模板专门保留了Edge Cases一节要求写出「当 [边界条件] 发生时会发生什么」「系统如何处理 [错误场景]」。这一节在 013-user-tasks/spec.md 中被填写为 10 条具体边界示范性极强无 assignee / candidates / invitations 的任务进入Unassigned仅管理员可见并记录告警释放任务立即撤销受保护内容访问回到Available或Unassigned操作 ID 复用且载荷相同时幂等载荷不同则冲突完成、超时、取消与 bookmark 移除的竞争通过 expected revision 与过渡态保证恰好一个终态胜出无法解析的配置表单阻塞完成并产生仅管理员可见的健康问题搜索永不扫描受保护的指令、任务数据、表单数据或完成数据。Edge Cases 是需求质量的试金石它们倒逼作者在动笔写功能需求前先把竞态、权限、失效路径想清楚也直接为下游 tasks 中的测试任务提供素材。Requirements功能需求编号与「待澄清」标记Requirements 节必填分为两部分Functional Requirements使用FR-###编号每条以 MUST 级别的强约束动词开头。模板给出了占位示例真实 spec 则写成了完整的 20 条例如- **FR-004**: Task status MUST follow Unassigned, Available, Assigned, transitional Completing/TimingOut/Cancelling, and terminal Completed/TimedOut/Cancelled states. - **FR-008**: The module MUST use opaque participant references composed of tenant, provider namespace, participant type, and external ID, with no required Elsa Identity dependency.模板还专门示范了如何标记不清楚的需求——用[NEEDS CLARIFICATION: ...]内联注明待澄清点而不是假装已经确定- **FR-006**: System MUST authenticate users via [NEEDS CLARIFICATION: auth method not specified - email/password, SSO, OAuth?]Key Entities可选当特性涉及数据时列出核心实体及其含义、关键属性与相互关系。真实案例中任务实体贯穿生命周期状态机Unassigned → Available → Assigned → Completing/TimingOut/Cancelling → Completed/TimedOut/Cancelled这正是 FR-004 在数据模型层面的落点并向下游>赞分享后端工作流自动化流程编排低代码【免费下载链接】elsa-coreThe Workflow Engine for .NET项目地址https://gitcode.com/gh_mirrors/el/elsa-core点击查看免费下载相关推荐IsaacLab Docker 部署避坑指南从启动到跑通验证IsaacLab Docker 部署避坑指南从启动到跑通验证 拉完镜像、起好容器进去跑任务却发现 nvidia smi 找不到——问题几乎总出在宿主机驱动层人工智能强化学习机器人具身智能深度学习为 GitHub Copilot 编写 AI-Ready 规格说明书awesome-copilot Specification Agent 模式实战指南为 GitHub Copilot 编写 AI Ready 规格说明书awesome copilot Specification Agent 模式实战指南 本文文档知识库AI 技能/插件上一篇CSGuide计算机学习路线2025年最新版全栈学习指南从入门到精通下一篇如何快速实现高质量WebGL文字渲染TinySDF完整指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/13 0:43:49

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/12 23:59:09

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/12 9:50:02

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/12 9:25:38

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/12 15:57:44

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/13 0:02:27

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉