name: mstar-harness-core description: "Lifecycle and authorization authority: delivery loop, state machine, Done ownership, task-category routing, topic index. Use for lifecycle, authorization, Done, routing, or CLI/plugin version drift." metadata: version: "1.0.0"

Morning Star Harness Core（晨星核心）

本 skill 是 harness 的唯一全局入口与裁决层。专题 skill 展开细节；冲突时以本 skill 的状态机、Done 权限与索引为准。

与其它 mstar-* skill 的加载契约

• 本 skill 是 harness 的生命周期 / 授权语义权威（状态机、Done 权限、门禁、路由以本 skill 为准）；加载选择权威是 `mstar-roles`（hub bootstrap → 角色身份 → Assignment Skill presets: 决策，见其 § Load Order）。本 skill 不维护第二份全局必读角色表。
• Directly invoked mstar-* topics declare mstar-harness-core first in Load Order / First action unless lintLoadOrder exempts their exact identity: standalone mstar-coding-behavior and the inbound-only mstar-engine-legacy archive — the archive may be referenced by runtime skills, it never names another topic skill. The existing mstar-roles hub bootstraps role-preset selection; explicit none still retains identity and shared-leaf authorization, anti-recursion, and evidence obligations.
• Load only topics selected by mstar-roles and the relevant topic index; do not read all topics as a precaution. General-engineering wording is not a load-order exemption.
• 加载条件（`mstar-engine-legacy`）：mstar-engine-legacy 是条件契约档案（engine-absent archive）。engine 约束激活（或宿主含 engine 能力）时不加载——engine-present 宿主以运行时 skills 的 engine-check 指针 + engine 校验为权威；仅 engine-absent 宿主（无 mstar CLI / engine import）为找回被 engine 校验接管的 contract 全文而读取（触发契约见其 description）。engine-absent 宿主没有文件执行路径：执行状态走对话追踪（no-plan mode）。

Standalone harness（mstar-* 自洽）

• `mstar-*` skill 体系在本仓库内自洽运行：正文与 load order 不得依赖仓库外的 skills、CLI、或 MCP 服务。
• Commands（如 /iteration-start）可引用本仓库 bundled、非 `mstar-*` 的辅助资产（例如 skills/grill-me/）；该引用仅存在于 command 层，不进入 mstar-* 专题索引或 load matrix。
• 框架/SDK/API 问题：先 Read/Grep 项目内文档、规格与源码；仍不确定时再向用户澄清。不将第三方文档工具写入 mstar-* 必读路径。

信息源优先级

1. 当轮用户显式指令
2. 项目 AGENTS.md / CLAUDE.md
3. 当轮相关 knowledge 文档（登记/完整性查 store.db catalog：mstar catalog list / show；{KNOWLEDGE_DIR}/README.md 若存在仅为散文导览，无登记行义务）
4. mstar-* skills（本 skill + 专题）
5. mstar-roles 角色正文

冲突且用户未覆盖 → 暂停升级人工。Knowledge 永不高于用户 / AGENTS.md。

最小交付循环

per-plan：specify → clarify → plan → plan(locked) → tasks → implement（多 task 默认 SDD）→ plan QC tri + QA gate（mandatory 派 QA 或 pm-acceptance）→ Done（inline 单席例外）。阶段细则 → `mstar-phase-gates`；QA 分级 → `mstar-roles/references/project-manager/qa-trigger-matrix.md`。独立交付 development plan 在 Done 后继续交付尾段 compound disposition → submit PR → merge-ready（resumable milestone）→ verify merge → terminal close/unregister/reconcile（verification/report-only 按注册声明的替代完成政策，无强制 PR；注册与尾段语义/失败行为的权威 = 冻结契约 `mstar-artifacts/references/plan-workflow-lifecycle-contract.md`，PM 步骤序列 → `mstar-roles/references/project-manager/plan-management.md`，compound disposition 步骤 → `mstar-compound/references/compound-workflow.md`）。迭代内 plan 行不各自走尾段，迭代整体走一次（见下行）。

迭代级：iteration-start → [per-plan cycle × N] → iteration-close → PR delivery → PR merge-ready loop。merge 是独立的授权动作：按 compass pr_merge_policy（reviewed-auto → PR 级 review 循环的 ship it 结论，须 settled、已 posted、且 head 等于当前 PR head，并且（仅当挂载了外部 review bot 时；无 bot 记 N/A）外部 AI review 在当前 head 达到其通过线（Greptile 5/5）、不失败、无 blocking finding；owner-gated → 人类 owner（操作者/用户，不是 coordinator 席位）对当前 PR head 的显式书面批准）判定，merge-ready / CI 绿 / QC Approve 各自都不构成授权；pr_merge_policy 缺失即停并回到 Phase 1。细则 → `mstar-iteration` → references/phase-4-5-pr-delivery.md §5.1b/§5.3。

Capture duty：确认的 finding 即落为 {HARNESS_DIR}/store.db 的 issue（计划内 mstar plan issue-add，计划外 mstar issue add；同一 finding 再次出现追加 occurrence，不新开第二个）——捕获只记证据，处置是独立的授权动作。cutover 落地后 open issue 即 residual SSOT（project register 只作迁移历史）。契约唯一权威 → `mstar-project-governance`「Issue capture」（本 skill 不复述）。

加载约定（强制）

加载选择 SSOT：`mstar-roles` hub § Load Order（Assignment Skill presets: 决策；PM required reading 不受 preset 门控）。下表是各角色的典型追加指引，不是第二套选择机制；冲突时以 hub 为准。

Routing eval（宿主插件内回归用，非运行时必读）→ .cursor/skills/mstar-routing-eval/。

状态机

Todo → InProgress → InReview → Done | Blocked

• Done sign-off belongs to project-manager or qualified QA evidence; the authoritative row write uses the sole primary coordinator's direct complete operation with QC/QA and declared-route proof. Leaf implementers never write Done.
• The primary coordinator uses revisable prepare, progress and direct complete; no per-row PM identity/bind/claim, sealed Assignment or transfer protocol. Default cleanup is allow-residual. Ordinary metadata/defaults need no ceremonial prepare record.

ACTIVE 状态字段权威在 store.db 的 root register / workflow / plan 行（唯一执行权威）；无 store 的 harness plan 不登记——走对话追踪（no-plan mode）；status.json / snapshot 仅迁移源/历史，project register 无条件退役为迁移历史。字段与 issue severity/lifecycle → `mstar-artifacts`。

Task category（路由摘要）

PM 在 Assignment 写 `Task category`（主类 + 可选 secondary）：

硬规则：quick 从不跳过 specify → clarify → plan；禁止把新 CLI/API/多模块/新测例标为 quick。已启用 {HARNESS_DIR} 时，首次 implement 前须有主 plan 路径 + workflow/plan 行登记（ACTIVE 在 store.db，经 mstar workflow register 等公共注册动词；无 store 则 plan 不登记——走对话追踪（no-plan mode），见 `mstar-conventions`）。workflow 注册本身是 authorized domain operation（经授权 producer 的引擎原语，不自创第二注册机制），语义 → 冻结契约 mstar-artifacts/references/plan-workflow-lifecycle-contract.md。

@explore 边界

• 已分派角色的 Assignment：禁止用 @explore 代替实现/测试/审查/文档交付。
• 允许短窄只读辅助；glob/grep/read 够用时不必 @explore。
• PM 分派前摸底：推荐；分派后承接方勿转包。

长任务纪律

可追踪清单（plan tasks 或 Todo）；偏离时 PM 拉回；完成前须可核对证据（实现侧自检见 `mstar-coding-behavior`；门禁证据见 `mstar-phase-gates` / `mstar-review-qc`）。

Durable Roadmap Gate：凡声明“分批 / 后续 / next plan / later / temporary workaround”的非热修任务，必须在可追踪载体写清后续路线（批次、依赖、owner/触发条件、完成定义）。可接受载体：{PLAN_DIR} 主 plan、CreatePlan mirror、store.db issue、PM Task Board，或 {HARNESS_DIR}/store.db 的 milestone —— milestone ID + 关联 issue 的 acceptance/owner/dependency/trigger 证据（mstar milestone 家族写入与只读 rollup；规则唯一权威 → `mstar-project-governance`「Milestone」，本 skill 不复述）。只在对话或 Completion Report 里说“以后做”不算可追踪，不能进入 implement GO 或 Done。

专题 skill 索引

宿主 mstar-host

Read `mstar-host` after this skill; it detects the active host and routes to the matching reference — host names, tool shapes and per-host entry details live only there（本表不重复维护）。

版本对齐（CLI ↔ host 插件）

• 全局 CLI 与已安装的宿主插件独立升级；版本漂移是已知故障源（skills/commands 与 CLI 预期不再匹配）。
• 检查：mstar-harness doctor --target <host>（各宿主 target 名 = mstar-host 检测表中该宿主的 id；已实现的宿主以 mstar-host 与 CLI --help 为准）。
• CLI 较新 → 提示用户更新宿主插件；插件较新 → 提示用户更新全局 CLI（npm i -g @mstar-harness/cli@latest）。
• 触发纪律：harness 行为异常/疑似过期、已知新版本发布后、或用户要求时运行——不是每个会话都跑。

定向执行与验证边界

本节是全部角色的范围与验证授权 SSOT；角色方法只展开其执行细节，Skill presets: none 仍由共享 leaf 边界承接这些限制。

• 本地全量测试默认禁止，完整套件交 CI。 只有用户明确许可才能例外；Assignment 的 Constraints 引用许可，Evidence Required 写明命令、范围、环境与次数。PM 字段、风险等级、缺证据、fix wave 和早期探索都不产生许可；不得拆成多个无关“小测试”绕过全量边界。
• 全域只读调查限早期探索。 实现、fix、QC、QA 只查本次变更、直接影响接口及相关 knowledge；不重新全仓扫描、测试或审查。通过知识索引只选相关 Active 条目；缺口超出范围时报告具体所缺信息，不自行扩展任务。
• 只读审查席位有界。 review / QC / L2 task review 的范围是 Assignment 的 diff pack 加直接影响接口；只在 must-fix 线索上跟进出界。默认 ≤ 12 次文件打开或 ≤ 10 分钟（PM 按 Assignment Budget 收紧，不得放宽）；席位还必须写明 Return shape（返回什么、如何在预算内停下），干净轮次显式返回 findings: [] 而非散文。Task category: audit 的轮次同受这两项约束，即使 Execute as 不在 QC 席位集内（audit 类请求可落在 @code-reviewer 之外的执行者上）。触达即停止扩展：返回当前 verdict 与已得 findings，并在报告 ## Scope 声明 Truncated coverage:。截断 ≠ `Unconfirmed`——后者仍是证据通道失败态并阻断 Approve；未覆盖范围按既有「未提及 = 未审查」由 PM 汇总，且部分覆盖的运行不可作为批准——门禁语义 → mstar-review-qc。
• 验证按变更映射。 可执行逻辑使用对应单测；非可执行文档与 prompt/skill 策略使用真实定向静态或 before/after 证据，不制造测试文件。SDD 的 Verification mode: scoped-check 格式与适用性 → mstar-sdd/references/file-handoffs.md。报告结构校验不证明命令执行或 diff 适用性，也不是任意 shell 拦截器。
• 只使受影响证据失效。 HEAD 或 Review range 改变不等于全部重跑；复用仍有效的 L1/CI/先前 QA 证据，记明原范围及仍适用的理由。fix 只验证相关回归；QC 复审只看归属 finding、fix delta 与直接接口。full tri-review 表示席位数量，不授权全仓 review；QC 不运行 test/build/install。
• QA 仅定向单元测试与验收证据映射。 模式仅 acceptance-only / targeted / report-only。用户许可的本地全量由实现 owner 或 ops 另接明确行动，QA 只消费证据。真实浏览器、真机、安装/部署 E2E 仅由用户显式启动独立 mstar-e2e workflow，PM 编排、ops 执行；不作为迭代 QA gate，也不作为开发 plan 的 task 或任何 gate 的证据义务——各层以自身单测/集成测试自证；真实环境验证只在该独立 workflow 内发生，其命名场景即该 workflow 的 plan rows。未验证的真实环境行为如实记录，不伪称通过。
• 开发验收禁止外部环境收据。 Prepare 时将开发 plan 的 AC/任务门禁中要求 live API、provider receipt、具名/已认证 host 或 account、已安装 plugin/artifact、真实 browser/device 或 deployed environment 证明的条目退回并在同一轮改为隔离 fixture、单元/组件/集成测试或本地构建 CLI/MCP 的可复现证据。QA/QC 不得重新要求这些收据；缺少真实环境证明只如实记未验证。用户另行授权的独立运维/E2E workflow 不受此开发 AC 禁令取消；不设关键词机器门禁。
• 依赖允许即并行。 PM 对无依赖、写所有权及 worktree 隔离的 ready tasks 并行派发；共享写目标、同一 session/ledger、前置接口与 integration merge 才按具体约束串行。leaf 不因并行策略获得派发权限。
• 恢复走原意图。 当前引擎可推导的 root、binding、token 与前置 bookkeeping 不要求操作者先复制/修补；先用目标动作并读取 applied / partial / replay 收据。只有不可推导的身份、目标选择、授权或真实冲突才要求补充事实；partial 保留已提交部分，不能宣称整个动作 mutation-free。leaf 不接收凭据。
• 完成即交付。 Assignment 给出任务、输入、所有权、允许检查与可观察结果；执行者只解答这些问题，不重复分析已解决内容、不顺手修复或增加“保险”检查。真实范围缺口返回 PM，已有证据充分即停止。

核心研发守则

Global engineering invariants apply to all harness roles; implementation and review practice → `mstar-coding-behavior`.

• Do not preserve backward compatibility. Remove obsolete paths instead of adding compatibility layers, fallbacks, or migrations.
• Choose the simplest implementation that fully meets the current requirements. Avoid speculative abstractions, configuration, and indirection.
• Grow the system in layers. Start from the smallest version that works end to end, and add each new capability on top of a product that already works. Never trade a working product for unfinished complexity.
• Keep components modular and concerns clearly separated.
• Prefer established, well-maintained libraries when they reduce overall complexity or improve reliability. Do not reimplement common functionality without a clear reason.
• Lean on the dependencies already in the project before writing your own implementation or adding packages. Do not assume a library lacks a capability without checking its documentation and types.
• Make architectural decisions for the long term. Do not accept a stopgap that only works for now and is meant to be replaced later.

护栏（不变量）

• 未经用户同意不改宿主配置文件与用户凭据。
• 行为变更须有验证证据。
• 业务仓默认功能分支（Assignment Branch policy 例外）→ `mstar-branch-worktree`。
• Dev 三角：@fullstack-dev 后端主导；UI → @frontend-dev；第二轨 → @fullstack-dev-2（mstar-roles PM 节）。
• 工期仅 agent-oriented → `mstar-conventions` · effort-estimation。
• plan-writing artifacts land in {PLAN_DIR}, not external default plan directories.
• PM Assignment 键名英文；任务正文可中文；产出/报告默认英文。

升级触发

验收仍模糊、评审冲突、重复失败、根因不可收敛 → 升级报告（状态、方案、推荐路径）。

专题 skill（规则在各自 SKILL.md）：mstar-phase-gates、mstar-branch-worktree、mstar-artifacts 等 — 见上表索引。