---
name: nucleus-context
description: Nucleus V2 baseline context validation and explicit standalone context discovery. Use when a workflow needs .nucleus/context validation, local candidate generation, or a blocked result for missing context fields.
---

# Nucleus Context

本 Skill 负责 Nucleus V2 baseline 的 context 入口能力。它安装在 Claude Code / Codex 等 coding agent 内部使用，不是 PMS 后端，也不是独立服务。

## 边界

- 只使用目标仓库 `.nucleus/**` 作为过程产物路径。
- `docs/requirement/**` 是受保护需求事实源；本 Skill 只读引用，不正式写入。
- `.autocode/**`、`.claude/notepads/**`、`docs/bugfix/**` 是 legacy risk path，命中 plannedWrites 必须阻塞。
- baseline `discover` 只接受显式输入，不做自然语言自由解析、不深扫知识库、不伪造 PMS product/repo/run。
- 缺 `workflowRunId` 时只能生成 local diagnostic blocked result；不得写 `.nucleus/context/<synthetic>.json`，不得让后续 workflow 用 synthetic id 继续。

## 子命令

```bash
python3 skills/nucleus-context/scripts/Nucleus_context.py validate \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json
```

```bash
python3 skills/nucleus-context/scripts/Nucleus_context.py discover \
  --repo-root <target-repo> \
  --mode standalone-assistant \
  --workflow-run-id <workflowRunId> \
  --workflow-id feature-development-prepare \
  --workflow-step context-validation \
  --provider codex \
  --primary-feature docs/features/<path>/feature.md \
  --requirement-solution docs/requirement/<req>/solution.md
```

```bash
python3 skills/nucleus-context/scripts/Nucleus_context.py build-blocked-result \
  --repo-root <target-repo> \
  --workflow-run-id <workflowRunId> \
  --workflow-id feature-development-prepare \
  --workflow-step context-validation \
  --blocker-code SCHEMA_VALIDATION_FAILED \
  --message "context 缺少必需字段"
```

## 输出

- `validate` 成功：写 `.nucleus/runs/<workflowRunId>/context-validation-gate.json`。
- `discover` 成功：写 `.nucleus/context/<workflowRunId>.json` 和 `.nucleus/runs/<workflowRunId>/context-discovery-report.json`。
- 缺 primary feature：写 `.nucleus/runs/<workflowRunId>/context-candidate.json` 和 blocked `.nucleus/runs/<workflowRunId>/result.json`，不写正式 context。
- 缺 `workflowRunId` 且 repo root 安全：写 `.nucleus/runs/wf-local-blocked-<timestamp>-<hash>/result.json`，`contextPath=null`。
- repo root 不安全：stdout 输出 machine-readable blocked payload，非零退出，不写目标仓库。

## 失败策略

所有失败默认 `ALERT_AND_BLOCK`。不要用自然语言总结替代 result package。