lambert/ai-parallel
1
0
Fork 0
Code Issues 9 Pull Requests 2 Actions Packages Projects Releases 1 Wiki Activity

[工程][Process] 建立 Issue 与 Agent/Automation 执行规范 #1

New Issue
Closed
opened 2026-09-14 20:02:02 +08:00 by CoderLambert · 3 comments
CoderLambert commented 2026-09-14 20:02:02 +08:00 (Migrated from github.com)
Copy Link
Copy Source

Problem

ai-parallel 即将进入 WXT + React + TypeScript 工程化改造阶段，后续会涉及多个可并行但存在共享热点的工程任务。当前仓库缺少统一的 Issue 执行合同、Scope Drift、Agent/定时任务 lane、handoff 与 closure 规则，容易出现多个任务同时修改 wxt.config.ts、Provider Registry、messaging/storage contract、DNR、background/workspace integration 等共享面。

Target

参考 CoderLambert/react-learning-playground 已验证的 Issue/Agent/Automation 规范，为 ai-parallel 建立项目适配版本：

  • Issue = adaptive execution contract；
  • Scheduled Task = durable ownership lane；
  • shared hotspot 单 writer；
  • 明确 READY / BLOCKED / Scope Drift / Validation / Closure；
  • 为 WXT migration 后续多任务执行提供统一 contract。

Invariants

  • 规范约束风险，不冻结实现细节。
  • 不把 Open Issue 自动视为 READY。
  • Acceptance Criteria 与 Validation 分离。
  • 不允许通过删测试、降低断言、扩大 timeout/retry 来制造 PASS。
  • 不把 Issue 或 Automation 变成第二套 Provider/architecture path taxonomy。
  • 暂不增加复杂 Issue lint/bot。

Execution Scope

Expected:

  • issue-rule.md
  • AGENTS.md
  • docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md

Sensitive / coordinate before expanding:

  • .github/workflows/**
  • package.json
  • extension runtime/product code

Out of scope by default:

  • WXT migration implementation
  • Issue template bot / GitHub App automation
  • CI ruleset changes
  • product behavior changes

Acceptance Criteria

  • Issue 标题、核心结构、READY/BLOCKED、Observed/Execution Base、Scope Drift、Validation、Closure 有明确规范。
  • 明确 AI Parallel 的 owner domains 与 shared hotspots。
  • Scheduled Task 有 lane count、ownership、resume/idempotency、stop condition 和标准 prompt。
  • Codex parent/sub-agent 有独立的 delegation contract。
  • 标准 handoff 可以表达 branch/PR/AC/validation/blocker。
  • 规范与当前 WXT 工程化目标一致，且不要求尚未存在的架构机制。

Validation

Focused:

  • 文档交叉引用与路径检查

Repository / Regression:

  • 不涉及运行时代码

Required CI:

  • 当前仓库 CI 保持不变

Dependencies

Hard blocked by:

  • none

Conflict / shared surfaces:

  • none for docs-only implementation
## Problem `ai-parallel` 即将进入 WXT + React + TypeScript 工程化改造阶段，后续会涉及多个可并行但存在共享热点的工程任务。当前仓库缺少统一的 Issue 执行合同、Scope Drift、Agent/定时任务 lane、handoff 与 closure 规则，容易出现多个任务同时修改 `wxt.config.ts`、Provider Registry、messaging/storage contract、DNR、background/workspace integration 等共享面。 ## Target 参考 `CoderLambert/react-learning-playground` 已验证的 Issue/Agent/Automation 规范，为 `ai-parallel` 建立项目适配版本： - Issue = adaptive execution contract； - Scheduled Task = durable ownership lane； - shared hotspot 单 writer； - 明确 READY / BLOCKED / Scope Drift / Validation / Closure； - 为 WXT migration 后续多任务执行提供统一 contract。 ## Invariants - 规范约束风险，不冻结实现细节。 - 不把 Open Issue 自动视为 READY。 - Acceptance Criteria 与 Validation 分离。 - 不允许通过删测试、降低断言、扩大 timeout/retry 来制造 PASS。 - 不把 Issue 或 Automation 变成第二套 Provider/architecture path taxonomy。 - 暂不增加复杂 Issue lint/bot。 ## Execution Scope Expected: - `issue-rule.md` - `AGENTS.md` - `docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md` Sensitive / coordinate before expanding: - `.github/workflows/**` - `package.json` - extension runtime/product code Out of scope by default: - WXT migration implementation - Issue template bot / GitHub App automation - CI ruleset changes - product behavior changes ## Acceptance Criteria - [ ] Issue 标题、核心结构、READY/BLOCKED、Observed/Execution Base、Scope Drift、Validation、Closure 有明确规范。 - [ ] 明确 AI Parallel 的 owner domains 与 shared hotspots。 - [ ] Scheduled Task 有 lane count、ownership、resume/idempotency、stop condition 和标准 prompt。 - [ ] Codex parent/sub-agent 有独立的 delegation contract。 - [ ] 标准 handoff 可以表达 branch/PR/AC/validation/blocker。 - [ ] 规范与当前 WXT 工程化目标一致，且不要求尚未存在的架构机制。 ## Validation Focused: - 文档交叉引用与路径检查 Repository / Regression: - 不涉及运行时代码 Required CI: - 当前仓库 CI 保持不变 ## Dependencies Hard blocked by: - none Conflict / shared surfaces: - none for docs-only implementation
CoderLambert commented 2026-09-14 20:05:18 +08:00 (Migrated from github.com)
Copy Link
Copy Source

[HANDOFF]

STATUS: DONE (pending merge)
ISSUE: #1
LANE: process-standards
EXECUTION_BASE: main@536e65750624eca3ed368e5e13d7a46a80a5332d
BRANCH: docs/project-execution-standards
HEAD: 2efc148996
PR: #3
OWNED_SCOPE: issue-rule.md; AGENTS.md; docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md
SENSITIVE_SURFACES_TOUCHED: none
AC_STATUS: complete in PR
VALIDATION: documentation cross-reference review complete; runtime/CI behavior unchanged
SECURITY_PERMISSION_DELTA: none
KNOWN_RISKS: standards are not effective on main until PR #3 merges
BLOCKERS: none
NEXT: review/merge PR #3

[HANDOFF] STATUS: DONE (pending merge) ISSUE: #1 LANE: process-standards EXECUTION_BASE: main@536e65750624eca3ed368e5e13d7a46a80a5332d BRANCH: docs/project-execution-standards HEAD: 2efc1489961541411b3905e1dc19cc74e7fc58a2 PR: #3 OWNED_SCOPE: issue-rule.md; AGENTS.md; docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md SENSITIVE_SURFACES_TOUCHED: none AC_STATUS: complete in PR VALIDATION: documentation cross-reference review complete; runtime/CI behavior unchanged SECURITY_PERMISSION_DELTA: none KNOWN_RISKS: standards are not effective on main until PR #3 merges BLOCKERS: none NEXT: review/merge PR #3
CoderLambert commented 2026-09-15 01:04:13 +08:00 (Migrated from github.com)
Copy Link
Copy Source

[CLOSURE]

Merged commit: 01d656e

Acceptance Criteria:

  • complete in the main branch using a concise AGENTS.md baseline plus on-demand issue-rule.md and docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md.
  • Covers Issue contract, READY/BLOCKED, Observed/Execution Base, Scope Drift, Validation, Closure, ownership domains/shared hotspots, scheduled lane lifecycle/idempotency/stop conditions, parent/sub-agent delegation, and standard handoff.

Validation:

  • focused: PASS (Markdown structure and paired fence review)
  • repository/regression: N/A; documentation-only
  • browser: N/A
  • required CI: existing CI remains unchanged; documentation-only push validation is pending

Scope deviation:

  • NONE

Security/permission delta:

  • NONE

Follow-ups:

  • NONE; old PR #3 was closed as superseded.
[CLOSURE] Merged commit: 01d656e Acceptance Criteria: - complete in the main branch using a concise `AGENTS.md` baseline plus on-demand `issue-rule.md` and `docs/execution/AUTOMATION-AND-AGENT-ORCHESTRATION.md`. - Covers Issue contract, READY/BLOCKED, Observed/Execution Base, Scope Drift, Validation, Closure, ownership domains/shared hotspots, scheduled lane lifecycle/idempotency/stop conditions, parent/sub-agent delegation, and standard handoff. Validation: - focused: PASS (Markdown structure and paired fence review) - repository/regression: N/A; documentation-only - browser: N/A - required CI: existing CI remains unchanged; documentation-only push validation is pending Scope deviation: - NONE Security/permission delta: - NONE Follow-ups: - NONE; old PR #3 was closed as superseded.
CoderLambert commented 2026-09-15 01:04:47 +08:00 (Migrated from github.com)
Copy Link
Copy Source

[CLOSURE-UPDATE]

Commit 01d656e verification completed:

Documentation-only change; no runtime, permission, or release behavior changed.

[CLOSURE-UPDATE] Commit `01d656e` verification completed: - CI: PASS https://github.com/CoderLambert/ai-parallel/actions/runs/34872443119 - Browser Smoke: PASS https://github.com/CoderLambert/ai-parallel/actions/runs/34872443035 Documentation-only change; no runtime, permission, or release behavior changed.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
accessibility
Barrier affecting people with disabilities
 bug
Something isn't working
 documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 question
Further information is requested
 wontfix
This will not be worked on
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
lambert
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: lambert/ai-parallel#1