refactor(meta): align task frontmatter metadata (#553)

CodeCasterX · codex · claude · web-flow · commit 3a7a18b14b7b · 2026-06-30T15:33:19.000+08:00
- Align task template type, workflow, and status metadata with validator enums.
- Remove unused frontmatter fields from task creation and import docs.
- Keep task metadata fixtures and quickstart examples consistent with the cleaned schema.

Co-authored-by: Codex &lt;noreply@openai.com&gt;
Co-authored-by: Claude &lt;noreply@anthropic.com&gt;
diff --git a/.agents/QUICKSTART.md b/.agents/QUICKSTART.md
@@ -47,8 +47,8 @@ cp .agents/templates/task.md .agents/workspace/active/task-001.md
 
 ```yaml
 id: task-001
-type: feature          # feature | bugfix | refactor | docs | review
-status: open           # open | in-progress | review | blocked | completed
+type: feature          # feature | bugfix | refactor | docs | chore
+status: active         # active | blocked | completed
 assigned_to: claude    # claude | codex | gemini | opencode | human
 ```
 
diff --git a/.agents/rules/task-management.md b/.agents/rules/task-management.md
@@ -35,7 +35,7 @@
 - `create-pr`：更新 `pr_number`、`updated_at`、`agent_infra_version`
 - `commit`：更新 `updated_at`、`agent_infra_version`；必要时更新 `current_step`（详见 `commit/reference/task-status-update.md`）
 - `complete-task`：更新 `status`、`current_step`、`completed_at`、`updated_at`、`agent_infra_version`
-- `block-task`：更新 `status`、`blocked_at`、`blocked_reason`、`updated_at`、`agent_infra_version`
+- `block-task`：更新 `status`、`blocked_at`、`updated_at`、`agent_infra_version`
 - `cancel-task`：更新 `status`、`cancelled_at`、`cancel_reason`、`updated_at`、`agent_infra_version`
 
 ## Activity Log started / done 双标记约定（单一事实源）
diff --git a/.agents/skills/create-task/SKILL.md b/.agents/skills/create-task/SKILL.md
@@ -93,7 +93,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # 必填；由 AI 从标题/描述推断；Urgent | High | Medium | Low
 effort:                    # 必填；由 AI 从标题/描述推断；High | Medium | Low
 start_date:                # 可选；YYYY-MM-DD
@@ -102,7 +101,6 @@ current_step: requirement-analysis
 assigned_to: {当前 AI 代理}
 ```
 
-注意：`created_by` 为 `human`，因为任务来源于用户的描述。
 priority / effort 必填：由 AI 从任务标题与描述推断后填入（候选值见 `.agents/rules/issue-fields.md`；中文输入按本地化映射规范化）。start_date / target_date 创建时保持留空：`start_date` 由 analyze 阶段写入、`target_date` 由 complete 阶段写入；不要臆测日期。
 
 ### 3. 更新任务状态
diff --git a/.agents/skills/import-codescan/SKILL.md b/.agents/skills/import-codescan/SKILL.md
@@ -54,9 +54,6 @@ description: >
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 codescan_alert_number: <alert-number>
-severity: <critical/high/medium/low>
-rule_id: <rule-id>
-tool: <tool-name>
 ```
 
 ### 3. 更新任务状态
diff --git a/.agents/skills/import-dependabot/SKILL.md b/.agents/skills/import-dependabot/SKILL.md
@@ -55,7 +55,6 @@ description: >
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 security_alert_number: <alert-number>
-severity: <critical/high/medium/low>
 cve_id: <CVE-ID>
 ghsa_id: <GHSA-ID>
 ```
diff --git a/.agents/skills/import-issue/SKILL.md b/.agents/skills/import-issue/SKILL.md
@@ -93,7 +93,7 @@ date +%Y%m%d-%H%M%S
 
 - 创建目录：`.agents/workspace/active/{task-id}/`
 - 使用 `.agents/templates/task.md` 模板创建 `task.md`
-- 场景 C 优先沿用远端 frontmatter 中的 `type`、`workflow`、`branch`、`created_by`、`milestone`；缺失或损坏字段按 Issue 标签和当前规则重新推断
+- 场景 C 优先沿用远端 frontmatter 中的 `type`、`workflow`、`branch`、`milestone`；缺失或损坏字段按 Issue 标签和当前规则重新推断
 - `current_step` 始终写入 `requirement-analysis`，不要恢复为远端原 `current_step`
 
 任务元数据：
@@ -107,7 +107,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # 可选；有来源/frontmatter 值时保留
 effort:                    # 可选；有来源/frontmatter 值时保留
 start_date:                # 可选；有明确 YYYY-MM-DD 时保留
diff --git a/.agents/templates/task.md b/.agents/templates/task.md
@@ -1,9 +1,9 @@
 ---
 id: task-XXX
-type: feature                  # feature | bugfix | refactor | docs | review
+type: feature                  # feature | bugfix | refactor | docs | chore
 branch:                        # <project>-<type>-<slug>
-workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
-status: open                   # open | in-progress | review | blocked | completed
+workflow: feature-development  # feature-development | bug-fix | refactoring
+status: active                 # active | blocked | completed
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 agent_infra_version: v0.0.0    # 当前 agent-infra 版本；由工作流命令刷新
diff --git a/templates/.agents/QUICKSTART.zh-CN.md b/templates/.agents/QUICKSTART.zh-CN.md
@@ -47,8 +47,8 @@ cp .agents/templates/task.md .agents/workspace/active/task-001.md
 
 ```yaml
 id: task-001
-type: feature          # feature | bugfix | refactor | docs | review
-status: open           # open | in-progress | review | blocked | completed
+type: feature          # feature | bugfix | refactor | docs | chore
+status: active         # active | blocked | completed
 assigned_to: claude    # claude | codex | gemini | opencode | human
 ```
 
diff --git a/templates/.agents/rules/task-management.en.md b/templates/.agents/rules/task-management.en.md
@@ -35,7 +35,7 @@ Map user intent to the corresponding workflow command:
 - `create-pr`: update `pr_number`, `updated_at`, `agent_infra_version`
 - `commit`: update `updated_at`, `agent_infra_version`; update `current_step` when needed (see `commit/reference/task-status-update.md`)
 - `complete-task`: update `status`, `current_step`, `completed_at`, `updated_at`, `agent_infra_version`
-- `block-task`: update `status`, `blocked_at`, `blocked_reason`, `updated_at`, `agent_infra_version`
+- `block-task`: update `status`, `blocked_at`, `updated_at`, `agent_infra_version`
 - `cancel-task`: update `status`, `cancelled_at`, `cancel_reason`, `updated_at`, `agent_infra_version`
 
 ## Activity Log started / done dual-marker convention (single source of truth)
diff --git a/templates/.agents/rules/task-management.zh-CN.md b/templates/.agents/rules/task-management.zh-CN.md
@@ -35,7 +35,7 @@
 - `create-pr`：更新 `pr_number`、`updated_at`、`agent_infra_version`
 - `commit`：更新 `updated_at`、`agent_infra_version`；必要时更新 `current_step`（详见 `commit/reference/task-status-update.md`）
 - `complete-task`：更新 `status`、`current_step`、`completed_at`、`updated_at`、`agent_infra_version`
-- `block-task`：更新 `status`、`blocked_at`、`blocked_reason`、`updated_at`、`agent_infra_version`
+- `block-task`：更新 `status`、`blocked_at`、`updated_at`、`agent_infra_version`
 - `cancel-task`：更新 `status`、`cancelled_at`、`cancel_reason`、`updated_at`、`agent_infra_version`
 
 ## Activity Log started / done 双标记约定（单一事实源）
diff --git a/templates/.agents/skills/create-task/SKILL.en.md b/templates/.agents/skills/create-task/SKILL.en.md
@@ -94,7 +94,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # required; inferred by the AI from the title/description; Urgent | High | Medium | Low
 effort:                    # required; inferred by the AI from the title/description; High | Medium | Low
 start_date:                # optional; YYYY-MM-DD
@@ -103,7 +102,6 @@ current_step: requirement-analysis
 assigned_to: {current AI agent}
 ```
 
-Note: `created_by` is `human` because the task comes from the user's description.
 priority / effort are required: the AI infers them from the task title and description (candidates in `.agents/rules/issue-fields.md`; normalize localized input). Leave start_date / target_date empty at creation: `start_date` is written by the analyze stage and `target_date` by the complete stage; do not invent dates.
 
 ### 3. Update Task Status
diff --git a/templates/.agents/skills/create-task/SKILL.zh-CN.md b/templates/.agents/skills/create-task/SKILL.zh-CN.md
@@ -93,7 +93,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # 必填；由 AI 从标题/描述推断；Urgent | High | Medium | Low
 effort:                    # 必填；由 AI 从标题/描述推断；High | Medium | Low
 start_date:                # 可选；YYYY-MM-DD
@@ -102,7 +101,6 @@ current_step: requirement-analysis
 assigned_to: {当前 AI 代理}
 ```
 
-注意：`created_by` 为 `human`，因为任务来源于用户的描述。
 priority / effort 必填：由 AI 从任务标题与描述推断后填入（候选值见 `.agents/rules/issue-fields.md`；中文输入按本地化映射规范化）。start_date / target_date 创建时保持留空：`start_date` 由 analyze 阶段写入、`target_date` 由 complete 阶段写入；不要臆测日期。
 
 ### 3. 更新任务状态
diff --git a/templates/.agents/skills/import-codescan/SKILL.en.md b/templates/.agents/skills/import-codescan/SKILL.en.md
@@ -54,9 +54,6 @@ Task metadata:
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 codescan_alert_number: <alert-number>
-severity: <critical/high/medium/low>
-rule_id: <rule-id>
-tool: <tool-name>
 ```
 
 ### 3. Update Task Status
diff --git a/templates/.agents/skills/import-codescan/SKILL.zh-CN.md b/templates/.agents/skills/import-codescan/SKILL.zh-CN.md
@@ -54,9 +54,6 @@ description: >
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 codescan_alert_number: <alert-number>
-severity: <critical/high/medium/low>
-rule_id: <rule-id>
-tool: <tool-name>
 ```
 
 ### 3. 更新任务状态
diff --git a/templates/.agents/skills/import-dependabot/SKILL.en.md b/templates/.agents/skills/import-dependabot/SKILL.en.md
@@ -55,7 +55,6 @@ Task metadata must include:
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 security_alert_number: <alert-number>
-severity: <critical/high/medium/low>
 cve_id: <CVE-ID>
 ghsa_id: <GHSA-ID>
 ```
diff --git a/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md b/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md
@@ -55,7 +55,6 @@ description: >
 ```yaml
 id: TASK-{yyyyMMdd-HHmmss}
 security_alert_number: <alert-number>
-severity: <critical/high/medium/low>
 cve_id: <CVE-ID>
 ghsa_id: <GHSA-ID>
 ```
diff --git a/templates/.agents/skills/import-issue/SKILL.en.md b/templates/.agents/skills/import-issue/SKILL.en.md
@@ -93,7 +93,7 @@ date +%Y%m%d-%H%M%S
 
 - Create the directory: `.agents/workspace/active/{task-id}/`
 - Use the `.agents/templates/task.md` template to create `task.md`
-- For Scenario C, prefer `type`, `workflow`, `branch`, `created_by`, and `milestone` from the remote frontmatter; infer missing or damaged fields from Issue labels and current rules
+- For Scenario C, prefer `type`, `workflow`, `branch`, and `milestone` from the remote frontmatter; infer missing or damaged fields from Issue labels and current rules
 - Always write `current_step` as `requirement-analysis`; do not restore the remote original `current_step`
 
 Task metadata:
@@ -107,7 +107,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # optional; preserve source/frontmatter value when available
 effort:                    # optional; preserve source/frontmatter value when available
 start_date:                # optional; preserve explicit YYYY-MM-DD when available
diff --git a/templates/.agents/skills/import-issue/SKILL.zh-CN.md b/templates/.agents/skills/import-issue/SKILL.zh-CN.md
@@ -93,7 +93,7 @@ date +%Y%m%d-%H%M%S
 
 - 创建目录：`.agents/workspace/active/{task-id}/`
 - 使用 `.agents/templates/task.md` 模板创建 `task.md`
-- 场景 C 优先沿用远端 frontmatter 中的 `type`、`workflow`、`branch`、`created_by`、`milestone`；缺失或损坏字段按 Issue 标签和当前规则重新推断
+- 场景 C 优先沿用远端 frontmatter 中的 `type`、`workflow`、`branch`、`milestone`；缺失或损坏字段按 Issue 标签和当前规则重新推断
 - `current_step` 始终写入 `requirement-analysis`，不要恢复为远端原 `current_step`
 
 任务元数据：
@@ -107,7 +107,6 @@ status: active
 created_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 updated_at: {YYYY-MM-DD HH:mm:ss±HH:MM}
 agent_infra_version: {agent_infra_version}
-created_by: human
 priority:                  # 可选；有来源/frontmatter 值时保留
 effort:                    # 可选；有来源/frontmatter 值时保留
 start_date:                # 可选；有明确 YYYY-MM-DD 时保留
diff --git a/templates/.agents/templates/task.en.md b/templates/.agents/templates/task.en.md
@@ -1,9 +1,9 @@
 ---
 id: task-XXX
-type: feature                  # feature | bugfix | refactor | docs | review
+type: feature                  # feature | bugfix | refactor | docs | chore
 branch:                        # <project>-<type>-<slug>
-workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
-status: open                   # open | in-progress | review | blocked | completed
+workflow: feature-development  # feature-development | bug-fix | refactoring
+status: active                 # active | blocked | completed
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 agent_infra_version: v0.0.0    # Current agent-infra version; refreshed by workflow commands
diff --git a/templates/.agents/templates/task.zh-CN.md b/templates/.agents/templates/task.zh-CN.md
@@ -1,9 +1,9 @@
 ---
 id: task-XXX
-type: feature                  # feature | bugfix | refactor | docs | review
+type: feature                  # feature | bugfix | refactor | docs | chore
 branch:                        # <project>-<type>-<slug>
-workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
-status: open                   # open | in-progress | review | blocked | completed
+workflow: feature-development  # feature-development | bug-fix | refactoring
+status: active                 # active | blocked | completed
 created_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 updated_at: YYYY-MM-DDTHH:mm:ss±HH:MM
 agent_infra_version: v0.0.0    # 当前 agent-infra 版本；由工作流命令刷新
diff --git a/tests/e2e/core/validate-artifact-helpers.ts b/tests/e2e/core/validate-artifact-helpers.ts
@@ -131,7 +131,6 @@ function buildTaskFrontmatter(overrides: FrontmatterOverrides = {}) {
     created_at: formatTimestamp(new Date(now.getTime() - 60_000)),
     updated_at: formatTimestamp(now),
     issue_number: "N/A",
-    created_by: "human",
     current_step: "code",
     assigned_to: "codex",
     ...overrides
