Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 12 additions & 52 deletions .github/ISSUE_TEMPLATE/work-item.md
Original file line number Diff line number Diff line change
@@ -1,66 +1,26 @@
---
name: 开发条目(计划卡)
about: PARALLEL-1 计划卡:一个可独立合入的主题分支
name: 开发条目
about: 记录问题、实现目标和验证方式
title: "<type>: <topic>"
labels: ["work-item"]
---

<!-- 见 docs/08-governance/parallel-workflow.md 第 5.1 节。不要写入凭据、真实 IP、用户名或本地路径。 -->
## 问题与目标

## 条目与来源
当前行为、具体例子与预期结果:

- OQ 或当前状态 §7 优先项:
- 目标:
## 实施范围

## 基线
相关对象、文件、依赖和分工:

`origin/main`:
## 验证

## 目标与非目标
对应输入、状态转换和实际运行方式:

- 目标:
- 非目标:
## 研究依赖

## 文件集
所需性质、已有模型或研究 Issue,以及受影响的部分:

预计修改或新增:
## 交付

-

热点文件:

-

## 依赖

无 / 必须先合入:

## 验证计划

- 本次运行:
- 多虚拟机、物理双机或 B 机时段:不需要

## 理论依赖

无 / `theory-gap` Issue:#(PARALLEL-1 第 5.6 节)

## 文档同步

- CONTRIBUTING §7 适用行:
- 当前状态 §8:

## 验收标准

- [ ]

## 不得宣称

-

## 分支

`<docs|fix|feat>/<topic>`

## 并行判定

可并行 / 排队(等待 #) / 需排期
分支、变更说明与维护者审计入口:
39 changes: 8 additions & 31 deletions .github/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,21 @@
<!-- PARALLEL-1:docs/08-governance/parallel-workflow.md。不要写入凭据、真实 IP、用户名或本地路径。 -->
<!-- 当前开发政策:docs/development-policy.md。 -->

Closes #

## Change

## Problem / counterexample
具体问题与改后行为:

## Status before → after
## 本次验证

## Tests or proofs(本次执行)
命令、退出码与结果:

| 命令 | 基线 SHA | 退出码 |
|---|---|---|
| | | |
## 相关文档与研究

## Evidence tags
受影响的接口说明、证据和已有研究问题:

无 / `evidence/<YYYYMMDD>-<topic>`
## 剩余事项

## 理论缺口

<!-- PARALLEL-1 第 5.6 节。只有 Issue 链接不算完成:每个缺口都写明属于哪一种以及适用范围。 -->

无 / 逐项列出:

- **阻塞**(#):已停下的验收标准:
- **不阻塞**(#):`ASSUMPTION` 标记所在的文件与位置:
- **维护者已关闭,建模解决**(#):模型或推导所在位置:
- **维护者已关闭,作为经验证据接受**(#):适用范围;“经验证据(限某范围),见 #N”标记所在的文件与位置:

## Residual risk

## Documents updated

## 合并检查

- [ ] 改动文件都在计划卡的文件集内,或计划卡已更新
- [ ] PARALLEL-1 审计没有未关闭的 `BLOCKER` / `MAJOR`
- [ ] 已用 `/aclt-sync` 与最新 `main` 同步,本次重跑通过
- [ ] CI 通过
- [ ] DCO:外部贡献的每个提交都已签署,维护者已在本地运行 `scripts/check-dco.py` 核验;签名者(维护者,或签名名单中由维护者授权的人类协作者)已在本正文最末尾另起一段加上 `Signed-off-by`,`dco` 检查通过(CONTRIBUTING §11)
维护者审计与合并前需处理的具体事项:

<!-- DCO(CONTRIBUTING §11):签名者(维护者,或签名名单中由维护者授权的人类协作者)合并前在本行下方另起一段加上签名行 `Signed-off-by: 姓名 <邮箱>`。只有正文最末尾的 trailer 区才算数;正文中只含 `---` 的行会把之后的内容当成补丁区。代理不填写本段。 -->
45 changes: 17 additions & 28 deletions .github/workflows/dco.yml
Original file line number Diff line number Diff line change
@@ -1,33 +1,7 @@
# SPDX-License-Identifier: Apache-2.0
name: DCO sign-off
# Trust boundary: for pull requests this uses pull_request_target, so the
# workflow and scripts/check-dco.py come from the target branch's current
# commit (github.sha), never from the pull request. The pull request's
# recorded base commit may predate this script, so the trusted checkout must
# not use github.event.pull_request.base.sha. The pull request is checked out
# into pr/ as data only; nothing from it is executed, no secrets are used, and
# the token is read-only and not persisted.
#
# The pull request body is untrusted. It is the only such field this check
# reads: the step below passes it in the PR_BODY environment variable and the
# trusted script picks it up by name (--body-env), so it is never interpolated
# into a run: command, never executed, and never written to GITHUB_ENV or
# GITHUB_OUTPUT. The title and the head branch name are not used at all.
#
# The squash merge takes its commit message from the pull request body, so the
# body must end with a Signed-off-by trailer from a sign-off identity in
# .github/dco-maintainers.txt before the merge; the edited activity type reruns
# the check when the signer adds it. The list holds the maintainer and the human
# collaborator the maintainer authorised, and it comes from inside the trusted
# checkout, so a pull request that edits that file is still judged by the target
# branch's copy. Only the signer is checked: commits on a branch of this
# repository are covered by the body sign-off, while a fork pull request still
# needs a matching sign-off on every commit.
#
# Until a fork pull request has shown on the public repository that this check
# blocks merging when a sign-off is missing and passes on the fixed head, its
# result for external pull requests is advisory; the maintainer verifies
# locally before merging (CONTRIBUTING section 11).
# PR policy and sign-off checks run from the trusted target branch.
# PR content is passed as data; the token has read-only permissions.
on:
pull_request_target:
types: [opened, synchronize, reopened, edited]
Expand All @@ -43,6 +17,21 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- name: Apply organization contribution policy
if: github.event_name == 'pull_request_target'
env:
AUTHOR_ASSOCIATION: ${{ github.event.pull_request.author_association }}
HEAD_OWNER: ${{ github.event.pull_request.head.repo.owner.login }}
BASE_OWNER: ${{ github.repository_owner }}
run: |
python3 - <<'PYTHON'
import os
association = os.environ['AUTHOR_ASSOCIATION']
same_owner = os.environ['HEAD_OWNER'].casefold() == os.environ['BASE_OWNER'].casefold()
if association not in ('OWNER', 'MEMBER') or not same_owner:
raise SystemExit('Organization-external pull requests are paused by the maintainer.')
print('PASS: organization contribution policy')
PYTHON
- name: Checkout the trusted checker
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
with:
Expand Down
7 changes: 3 additions & 4 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -115,11 +115,10 @@ jobs:
echo "base=$base" >> "$GITHUB_OUTPUT"
echo "channel=$channel; reason=$reason" >&2
echo "::notice title=Validation channel::${channel} (${reason})"
# Keep this gate before evidence checks and tests.
- name: Check tested environment scope
- name: Record execution environment
run: python3 -B scripts/check-environment.py --full
- name: Verify retained source pins against Git
run: python3 -B scripts/check-repository-evidence.py --repository .
- name: Check documents and retained metadata
run: python3 -B scripts/check-repository-evidence.py
- name: Run documentation-only validation
if: steps.classify.outputs.channel == 'fast'
env:
Expand Down
Loading
Loading