跳到正文
cccskills
免费在 GitHub 公开

workspace-init

Initialize a missing research Workspace from the repository template without overwriting existing Run state; use before Pipeline binding when the target under `workspaces/` has no valid core artifacts.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(22)

  • SKILL.md3.2 KB
  • assets/workspace-template/CHECKPOINTS.md1.3 KB
  • assets/workspace-template/citations/ref.bib72 B
  • assets/workspace-template/citations/verified.jsonl1 B
  • assets/workspace-template/DECISIONS.md396 B
  • assets/workspace-template/GOAL.md122 B
  • assets/workspace-template/outline/claim_evidence_matrix.md121 B
  • assets/workspace-template/outline/mapping.tsv75 B
  • assets/workspace-template/outline/outline.yml370 B
  • assets/workspace-template/outline/taxonomy.yml333 B
  • assets/workspace-template/output/DRAFT.md128 B
  • assets/workspace-template/output/QUALITY_GATE.md217 B
  • assets/workspace-template/output/RUN_ERRORS.md155 B
  • assets/workspace-template/output/SNAPSHOT.md81 B
  • assets/workspace-template/papers/core_set.csv37 B
  • assets/workspace-template/papers/paper_notes.jsonl1 B
  • assets/workspace-template/papers/papers_dedup.jsonl1 B
  • assets/workspace-template/papers/papers_raw.jsonl1 B
  • assets/workspace-template/queries.md790 B
  • assets/workspace-template/STATUS.md170 B
  • assets/workspace-template/UNITS.csv268 B
  • scripts/run.py1.3 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Workspace Init

Initialization is a boundary: it creates Workspace-owned state and leaves existing state untouched unless overwrite is an explicit operator decision. It does not select a Workflow or execute a Unit.

Inputs

  • Target directory under workspaces/<name>/.
  • Optional explicit overwrite decision.

Outputs

  • STATUS.md, CHECKPOINTS.md, UNITS.csv, and DECISIONS.md.
  • GOAL.md and queries.md.
  • papers/, outline/, citations/, and output/ directories.

Steps

1. Validate the destination

Resolve the target path and reject the repository root. Inspect existing files before deciding whether initialization is missing, partial, or already complete. Never infer overwrite permission from a partial Workspace.

Completion criterion: the destination is a Workspace path and every existing file that could be replaced is known.

2. Materialize the base template

Copy the repository-owned template into the target. Default to create-missing; use --overwrite only after an explicit replacement decision.

Completion criterion: all missing base files and directories are materialized, and no pre-existing file was replaced without explicit permission.

3. Verify the core contract

Confirm that STATUS.md, UNITS.csv, CHECKPOINTS.md, and DECISIONS.md exist. Parse the UNITS.csv header and reject malformed CSV rather than leaving a superficially initialized Workspace.

Completion criterion: the four core files exist and UNITS.csv has the required schema.

4. Hand off to Workflow binding

Leave Workflow selection and Pipeline-specific Unit materialization to pipeline-router or the Pipeline adapter. The generic template is not evidence that a Goal has been routed.

Completion criterion: the Workspace can be passed to the router without requiring any state from chat history.

Context Pointers

  • Read assets/workspace-template/ only when inspecting or changing the base template contract.
  • Read the selected pipelines/*.pipeline.md only after Workflow binding.
  • Use research-pipeline-runner when the user asked to continue beyond initialization.

Script

Quick Start

uv run python .codex/skills/workspace-init/scripts/run.py \
  --workspace workspaces/<name>

All Options

  • --workspace <path>: target Workspace.
  • --overwrite: replace existing template-owned files after explicit approval.
  • --unit-id, --inputs, --outputs, --checkpoint: Pipeline-runner compatibility arguments.

Examples

Inspect the interface before use:

uv run python .codex/skills/workspace-init/scripts/run.py --help

Replace template files only after an explicit reset decision:

uv run python .codex/skills/workspace-init/scripts/run.py \
  --workspace workspaces/<name> \
  --overwrite

Troubleshooting

  • Existing files remain unchanged by default. This is the expected idempotent behavior, not an initialization failure.
  • Never point the script at the repository root; use workspaces/<name>/.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Internal template for creating or refactoring a skill into the repository's reference-first shape. **Trigger**: reference-first template, blueprint skill, create a reusable skill, refactor a script-heavy skill. **Use when**: you need a lean `SKILL.md`, explicit `references/`, machine-readable `assets/`, and a minimal deterministic `run.py`.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

Download a small corpus of open-access arXiv survey/review PDFs about agentic systems and extract text for style learning.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

Extract per-subsection “anchor facts” (NO PROSE) from evidence packs so the writer is forced to include concrete numbers/benchmarks/limitations instead of generic summaries.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

Curate reader-facing survey tables for the Appendix (clean layout + high information density), using only in-scope evidence and existing citation keys.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

Build a final, machine-readable argument snapshot from current H3 sections and refresh section fingerprints before merge.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

Audit one research Workspace for declared Unit outputs and Pipeline target Artifacts, writing `output/CONTRACT_REPORT.md`; use for mid-Run coverage snapshots or final delivery completeness, not deep provenance integrity.

中文简介正在准备中。当前显示原文说明。

WILLOSCAR/research-units-pipeline-skills5152026年10月5日 更新

查看 WILLOSCAR 的全部技能

报告此技能的问题