missionforge-workflow

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

missionforge-workflow

The complete MissionForge workflow for managing AI-assisted software missions from start to finish. Use this as your reference for the full lifecycle.

这是用于管理AI辅助软件任务的完整MissionForge工作流，涵盖从开始到结束的全流程。可将其作为全生命周期的参考指南。

Install

安装

bash

pip install git+https://github.com/loudiman/Mission-Forge.git

bash

pip install git+https://github.com/loudiman/Mission-Forge.git

or from source:

pip install -e ".[dev]"

undefined

pip install -e ".[dev]"

undefined

Full Lifecycle

完整生命周期

Phase 1 — Initialize

阶段1 — 初始化

Create the mission workspace and define the parent mission:

bash

missionforge init MF-001

创建任务工作区并定义父任务：

bash

missionforge init MF-001

Edit .missionforge/missions/MF-001/mission.yaml

missionforge mission MF-001 --validate

undefined

missionforge mission MF-001 --validate

undefined

Phase 2 — Decompose

阶段2 — 分解

Break the parent mission into independently-executable sub-missions:

bash

missionforge decompose MF-001

将父任务拆分为可独立执行的子任务：

bash

missionforge decompose MF-001

Creates sub-mission templates in sub-missions/

Fill in each MF-001-A.yaml, MF-001-B.yaml, etc.

missionforge validate-submission MF-001 MF-001-A missionforge validate-submission MF-001 MF-001-B

undefined

missionforge validate-submission MF-001 MF-001-A missionforge validate-submission MF-001 MF-001-B

undefined

Phase 3 — Baseline

阶段3 — 基准捕获

Capture pre-implementation metrics for each sub-mission:

bash

missionforge baseline capture MF-001-A

为每个子任务捕获实施前的指标：

bash

missionforge baseline capture MF-001-A

Edit baseline.todo.json with measured values

missionforge baseline commit MF-001-A


Repeat for each sub-mission before writing any implementation code.

missionforge baseline commit MF-001-A


在编写任何实施代码前，为每个子任务重复上述步骤。

Phase 4 — Plan

阶段4 — 规划

Generate or review the execution plan:

bash

missionforge plan MF-001

生成或审核执行计划：

bash

missionforge plan MF-001

Phase 5 — Implement

阶段5 — 实施

Work through sub-missions in order. Use

next

to see what's up:

bash

missionforge next MF-001

Check workspace status anytime:

bash

missionforge workspace status

按顺序完成子任务。使用

next

命令查看待办事项：

bash

missionforge next MF-001

随时查看工作区状态：

bash

missionforge workspace status

Phase 6 — Report

阶段6 — 报告

Generate a mission report after implementation:

bash

missionforge report MF-001

实施完成后生成任务报告：

bash

missionforge report MF-001

Command Quick Reference

命令速查

Command	Purpose
`missionforge init <ID>`	Initialize mission workspace
`missionforge mission <ID> --validate`	Validate parent mission.yaml
`missionforge decompose <ID>`	Guided sub-mission decomposition
`missionforge validate-submission <ID> <SUB_ID>`	Validate a sub-mission file
`missionforge baseline capture <SUB_ID>`	Generate baseline.todo.json
`missionforge baseline commit <SUB_ID>`	Commit immutable baseline.json
`missionforge baseline reset <SUB_ID> --force`	Reset baseline for re-capture
`missionforge plan <ID>`	Generate execution plan
`missionforge next <ID>`	Show next sub-mission to implement
`missionforge report <ID>`	Generate mission report
`missionforge workspace status`	List all missions and their status

命令	用途
`missionforge init <ID>`	初始化任务工作区
`missionforge mission <ID> --validate`	验证父任务mission.yaml文件
`missionforge decompose <ID>`	引导式子任务分解
`missionforge validate-submission <ID> <SUB_ID>`	验证子任务文件
`missionforge baseline capture <SUB_ID>`	生成baseline.todo.json文件
`missionforge baseline commit <SUB_ID>`	提交不可修改的baseline.json文件
`missionforge baseline reset <SUB_ID> --force`	重置基准以重新捕获数据
`missionforge plan <ID>`	生成执行计划
`missionforge next <ID>`	显示下一个待实施的子任务
`missionforge report <ID>`	生成任务报告
`missionforge workspace status`	列出所有任务及其状态

Global Options

全局选项

bash

--verbose, -v     # Enable DEBUG logging
--log-file PATH   # Write logs to file

bash

--verbose, -v     # Enable DEBUG logging
--log-file PATH   # Write logs to file

Mission ID Conventions

任务ID命名规范

Parent:
```
MF-001
```
,
```
PROJ-042
```
,
```
FG-123A
```
Sub-mission:
```
MF-001-A
```
,
```
MF-001-B
```
,
```
PROJ-042-C
```

父任务：
```
MF-001
```
,
```
PROJ-042
```
,
```
FG-123A
```
子任务：
```
MF-001-A
```
,
```
MF-001-B
```
,
```
PROJ-042-C
```

Individual Skill Docs

独立技能文档

```
mission-init
```
— workspace initialization
```
mission-validate
```
— schema validation
```
mission-decompose
```
— decomposition workflow
```
baseline-capture
```
— baseline metrics

```
mission-init
```
— 工作区初始化
```
mission-validate
```
— schema验证
```
mission-decompose
```
— 分解工作流
```
baseline-capture
```
— 基准指标