工作流

Workflows 选项卡左侧是阶段列表。可先用 Idea Assessment 评估想法，或选择交付阶段（Project Setup、Backlog、Refinement 等）运行引导式命令卡片。

Idea Assessment 使用评估卡片与聊天流程；交付阶段则点击命令卡片并在聊天中回答问题。Raaghu Spec Kit 会创建 Wiki 页面、Azure Boards 工作项或报告。

你不必记住斜杠命令。如果是新手或非技术人员，优先走这条路径。

从这里开始（第一天）

对新项目来说，这些步骤足够起步：

1. 用 Raaghu Spec Kit 命令（Create Constitution / /speckit.constitution）创建 constitution — 每个项目一次。
2. 可选：对仍不确定的想法先运行 Idea Assessment，再 specify。
3. Project Setup → Create project foundation — 根据该 constitution 构建项目基础文档。
4. Backlog — 将文档转为 Epic、Feature 或故事（或使用 Intake 上传 BRD/PRD）。
5. 准备好后打开 Visuals，按层级同步 Boards 工作项。

下表按阶段列出全部交付命令卡片。第一天不必全部用到。

开始之前

1. 为项目 初始化 Raaghu Spec Kit。
2. 确认 AI 已连接。组织管理员和 Project Administrators 使用 Settings。若看不到 Settings，请联系管理员。
3. 对大多数 Project Setup 操作，请先用 Raaghu Spec Kit 命令（Create Constitution / /speckit.constitution）创建 constitution。

如何运行交付命令

1. 打开 Workflows。
2. 在左侧列表中选择一个阶段（例如 Project Setup）。
3. 点击一张命令卡片。
4. 回答聊天问题，然后审阅并保存。

使用 View all capabilities → 一次查看全部命令，或使用 ← Back to current phase 返回单个阶段。

若要在 specify 之前评估想法，请参阅 Idea Assessment。

Project Setup

设定项目基本规则：范围、质量检查、安全与审计。

命令	用途
Create project foundation	根据 Wiki 中的 constitution 生成七段式基础文档。在 constitution 已存在后使用。需要真实 constitution（不是空起始文件）。
Update project guidelines	根据关联工件或最新项目信息刷新 Project Constitution，并给出简短变更摘要。从文档更新时请先附加文件。
Publish project scope	将范围内、范围外与边界规则发布到 wiki。最好在基础文档已存在后使用。
Create delivery checklist	创建“可以开始”（Definition of Ready / DoR）和/或“可以完成”（Definition of Done / DoD）检查清单。之后冲刺就绪检查会用到。
Define compliance & security rules	写出团队交付前必须遵循的安全与合规规则。
Create traceability report	将需求与决策映射为可审计报告。若已有基础文档、护栏与检查清单会更完整。

典型流程： Create Constitution → Create project foundation → 按需使用其它 Project Setup 卡片。

Backlog

将文档转为 Azure Boards 工作：Epic、Feature 与故事。

命令	用途
Generate epics from linked artifacts	根据 Wiki 规范或故事提出顶层 Epic，并可在 Boards 中创建。
Split epics into features	将过大的 Epic 拆成子 Feature，并附带范围与验收说明。
Generate stories from selected feature	在你选择的 Feature 下创建用户故事。
Generate stories from linked artifacts	将 BRD/PRD 或 Wiki 文档直接变成故事，无需手工拆 Epic。
Generate intake summary from BRD/PRD	将 Intake 文档汇总为范围、风险与待解决问题。
Link artifacts to selected work item	将 Wiki 或规范路径链接到 Boards 工作项以便追溯。

Refinement

在团队承诺前改进现有故事。

命令	用途
Refine selected stories	改进描述与验收标准；可将更好的文本写回 Boards。
Standardize acceptance criteria	将标准改写成统一格式（例如 Given/When/Then 或要点）。
Detect missing requirements	查找边界情况、集成或非功能需求等缺口。
Attach NFRs to stories	将 non-functional requirements (NFRs) — 例如性能、安全与无障碍 — 映射到相关故事。
Detect duplicates or overlaps	报告相似故事。不会自行更改 Boards。
Highlight unclear or risky stories	按清晰度与风险打分，便于先处理薄弱项。

Sprint Planning

帮助准备冲刺：目标、任务、估算与就绪度。

命令	用途
Generate sprint goal from selected items	根据迭代或所选工作项起草简短冲刺目标。
Generate dev tasks from selected stories	在所选故事下创建实现任务。
Estimate tasks from plan	根据技术计划为任务建议工作量。
Identify cross-team dependencies	列出冲刺中对其它团队或系统的依赖。
Run readiness check (DoR validation)	按 DoR 检查清单核验工作项，并可保存报告。最好先完成 Create delivery checklist。

Development

在构建过程中支持团队。

命令	用途
Generate technical plan for selected feature	创建实现计划，并可保存到 Wiki。
Refine tasks into implementation steps	将 Boards 任务展开为有序步骤。
Generate test cases from selected stories	根据验收标准生成测试用例，交给 QA。
Convert bug to linked dev task	将缺陷转为关联的修复任务。
Track work items status from implementation progress	根据进度建议子工作项状态更新。

Testing & Quality

在发布前加强测试与验收。

命令	用途
Generate test strategy for selected epic	为 Epic 定义测试范围、层级、环境与风险。
Generate negative / edge test cases	在主流程之外增加失败路径与边界场景。
Generate test data matrix	列出有用的输入、角色与状态组合。
Validate acceptance criteria completeness	标出含糊、缺失或难以测试的验收标准。
Generate UAT checklist	为相关方生成用户验收走查清单。

Release

准备部署、门控与发布说明。

命令	用途
Generate CI pipeline checklist from constitution	起草与 constitution 对齐的 CI/CD 检查项。需要已填写的 constitution。
Generate release gates from compliance rules	根据合规规则定义“发布前必须通过”的门控。
Generate runbooks (deploy / rollback)	编写分步部署与回滚说明。
Generate release notes from completed work items	将已完成的 Boards 工作汇总为发布说明。
Publish release notes to Wiki	将格式化的发布说明发布到项目 Wiki。

Change Management

在基线确定后管理范围变更。

命令	用途
Detect scope drift from latest artifacts	将最新规范与约定范围比较并标出偏离。
Highlight changes since last PRD version	展示各 PRD 版本之间的变化。
Draft change request with impact analysis	起草含范围、时间线与影响的变更请求。
Mark items requiring approval	标记开始前需正式批准的 backlog 工作项。
Generate stakeholder approval checklist	创建含角色与证据链接的签字清单。

提示

• 从 Project Setup 开始，再进入 Backlog → Refinement → Sprint Planning。
• 若某命令需要你还没有的文档，请用另一张卡片、Intake 或 Raaghu Spec Kit 命令 先创建。
• 需要时可在聊天中 Stop generating 与 Retry。参见 聊天面板。

下一步

• Idea Assessment
• 你的第一个功能
• Raaghu Spec Kit 命令
• 聊天面板
• Intake