btspoony Morning Star Harness Core（晨星核心）
本 skill 是 harness 的唯一全局入口与裁决层。专题 skill 展开细节；冲突时以本 skill 的状态机、Done 权限与索引为准。
与其它 mstar-* skill 的加载契约
- 本 skill 是 harness 的生命周期 / 授权语义权威（状态机、Done 权限、门禁、路由以本 skill 为准）；加载选择权威是
mstar-roles（hub bootstrap → 角色身份 → AssignmentSkill presets:决策，见其 § Load Order）。本 skill 不维护第二份全局必读角色表。 - 独立直接调用专题（不经角色 hub bootstrap）时，
mstar-harness-core仍是首个依赖：各专题 SKILL.md 的 Load Order / First action 节须声明 core-first。唯一例外是mstar-roleshub bootstrap —— explicitnone下角色以身份 + 角色自有方法自洽，不强制读任何专题（含本 skill）；此时授权、反递归、证据诚实等 load-bearing 语义由角色引用与其 leaf 边界承接。 - 各专题 SKILL.md 含 Load order；按
mstar-roles的加载选择 + 本 skill 专题索引按需加载，禁止为「保险」通读全部专题。 - 加载条件（
mstar-engine-legacy）：mstar-engine-legacy是条件契约档案（engine-absent fallback）。engine 约束激活（或宿主含 engine 能力）时不加载——engine-present 宿主以运行时 skills 的 engine-check 指针 + engine 校验为权威；仅 engine-absent 宿主（无mstarCLI / engine import）为找回被 engine 校验接管的 contract 全文而读取（触发契约见其 description）。
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-*必读路径。
信息源优先级
- 当轮用户显式指令
- 项目
AGENTS.md/CLAUDE.md {KNOWLEDGE_DIR}/README.md索引（若该文件存在；发现 Active 行并仅跟随与当轮相关的文档）mstar-*skills（本 skill + 专题）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）。迭代内 plan 行不各自走尾段，迭代整体走一次（见下行）。
迭代级：iteration-start → [per-plan cycle × N] → iteration-close → PR delivery → PR merge-ready loop。细则 → mstar-iteration。
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 为准。
| 角色 | 始终 | 按任务追加（典型） |
|---|---|---|
| 全部 | 加载选择 → mstar-roles（hub § Load Order；本 skill = 生命周期/授权权威，mstar-roles hub bootstrap 是 core-first 的唯一例外） |
— |
@project-manager |
本 skill | mstar-dispatch-gates、mstar-phase-gates、mstar-conventions、mstar-roles；implement 波次 mstar-sdd；派 QC 前 mstar-review-qc；并行/审查 mstar-branch-worktree；plan/status/review bundle mstar-artifacts；UI 类 plan Prepare 阶段 mstar-design-md（DESIGN.md 门禁）；新建/大改 skill 时 mstar-skill-authoring；迭代管理 mstar-iteration（Phase 1–5）；战略性工作 mstar-strategy；audit 类请求 mstar-audit（执行归 @code-reviewer）；跑/解读 CLI 命令时 mstar-use-cli。不读 mstar-coding-behavior |
| 实现/审查/运维 | 本 skill + mstar-coding-behavior + 角色 ref |
有 git 写：mstar-branch-worktree；有 plan 路径：mstar-conventions；PM 派 QC 前：mstar-review-qc；qc-specialist*：mstar-roles → references/qc-specialist/；qa-engineer：references/qa-engineer/；改 status/residual：mstar-artifacts；UI：mstar-design-md；知识库：mstar-compound（PM）；跑/解读 CLI 命令时（各 leaf 角色按任务）：mstar-use-cli |
| leaf 承接方 | 上栏 + mstar-dispatch-gates（反递归节） |
— |
Routing eval（宿主插件内回归用，非运行时必读）→ .cursor/skills/mstar-routing-eval/。
状态机
Todo → InProgress → InReview → Done | Blocked
Done：仅@project-manager或@qa-engineer。- 实现类可设
InReview，不可设Done。
status.json（v2 根）/ workflow snapshot / project register 字段与 residual → mstar-artifacts。
Task category（路由摘要）
PM 在 Assignment 写 Task category（主类 + 可选 secondary）：
| Category | 倾向角色 |
|---|---|
visual |
@frontend-dev（复杂 IA 可前置 @product-manager） |
deep |
@explore → dev / @architect |
quick |
@general 或单 dev — 不豁免 Prepare |
logic |
@architect + dev |
ops |
@ops-engineer |
docs |
@product-manager / @architect / @writing-specialist |
audit |
@code-reviewer（mstar-audit 承载；大型仓库经 Assignment Delegation: allowed (scout/explore only, read-only) 扇出只读 scout；read-only advisory；不进入状态机） |
硬规则：quick 从不跳过 specify → clarify → plan；禁止把新 CLI/API/多模块/新测例标为 quick。已启用 {HARNESS_DIR} 时，首次 implement 前须有主 plan 路径 + status.json 登记（见 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”的非热修任务，必须在 {PLAN_DIR} 主 plan、CreatePlan mirror、status.json/residual、或 PM Task Board 中写清后续路线（批次、依赖、owner/触发条件、完成定义）。只在对话或 Completion Report 里说“以后做”不算可追踪，不能进入 implement GO 或 Done。
专题 skill 索引
| Skill | 职责 |
|---|---|
mstar-harness-core |
本文件：入口、状态机、Task category、explore、索引、护栏 |
mstar-use-cli |
CLI 契约（agent 面向）：任务→命令族索引、前置条件阶梯、两条协议序列、退出码 0 / 1 / 2 与稳定拒绝码读法；flags 一律以命令自身 --help 为准 |
mstar-phase-gates |
per-plan 双阶段门禁：Prepare/Execute、意图门禁、hotfix、可验证编辑 |
mstar-iteration |
迭代管理：Phase 1–5（start / Autonomous Execute / iteration-close / PR delivery / PR merge-ready loop） |
mstar-dispatch-gates |
派发、Delegation、反递归、依赖与隔离驱动并行、SDD 路径 plan QC 强制 tri |
mstar-engine-legacy |
条件契约档案（engine-absent fallback）：status v1→v2 字段历史、lease 协议全文、各宿主 N=3/N=1 重述、反递归全清单、Engine-check 样板；engine 激活时不加载 |
mstar-sdd |
Subagent-driven development：file handoff、per-task review、ledger |
mstar-branch-worktree |
功能分支、worktree、QC/QA 检出对齐 |
mstar-conventions |
{HARNESS_DIR} 发现、初始化、Spec 分支模型摘要、产物路径 SSOT |
mstar-artifacts |
主 plan、review bundle / durable summaries、status.json（v2 根）+ workflow snapshots + project register、residual、knowledge |
mstar-project-governance |
项目治理层：projects/<id>/roadmap.md 编写约定 + residuals.json register 生命周期（open → verified close in place）、_default 回退、provenance；schema 与 engine project.ts 逐字一致 |
mstar-design-md |
DESIGN.md 设计系统规范 —— 创建/审计/维护 design tokens，三级检查清单，light/dark 双主题 |
mstar-review-qc |
PM：QC tri 编排、residual 留档、四层边界；leaf 执行 → mstar-roles/references/qc-specialist/ |
mstar-coding-behavior |
Think / Simplicity / Surgical / Debugging / Review Feedback / Goal-Driven |
mstar-compound |
知识结晶 —— 已解决问题→结构化知识文档，双轨（Bug/Knowledge），「是否值得结晶」自检清单，重叠检测，可发现性检查，CONCEPTS.md 协同 |
mstar-compound-refresh |
知识维护 —— 审查/更新/合并/删除 {KNOWLEDGE_DIR} 文档；项目知识 bootstrap（无/残旧 STRATEGY.md、CONCEPTS.md、{KNOWLEDGE_DIR}）→ references/project-knowledge-bootstrap.md |
mstar-strategy |
STRATEGY.md 全局战略方向 —— 产品愿景、技术方向、决策原则 |
mstar-skill-authoring |
通用 skill 撰写门控（SkillsBench 六原则）：trigger 契约、紧凑 5 问 body、渐进披露、paired 证据 |
mstar-audit |
Variant carrier：common core（hard rules、recon、vet、variant dispatch）+ SKILL.md ## Plan output (all variants)（Status block、plan files、handoff）+ references/codebase-audit.md（full-audit 变体：9 类别 fan-out、effort、scope variants、Phase 4 excerpt/reconcile、audit index 模板）+ references/security-review.md（security 深查：exploitability 门槛、FP 纪律、LLM/供应链面）+ references/pr-review.md（pr 变体）；audit-playbook + finding-format + plan-quality-bar |
mstar-e2e |
用户显式启动的独立真实浏览器 / 真机 / E2E 验证 workflow；PM 编排、ops 执行，不进入迭代 QA gate |
mstar-roles |
角色正文 hub |
mstar-host |
宿主适配（自动识别；references/opencode.md / cursor.md / codex.md / kimi.md / parallel-dispatch.md） |
宿主 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-e2eworkflow，PM 编排、ops 执行；不作为迭代 QA gate，也不作为开发 plan 的 task 或任何 gate 的证据义务——各层以自身单测/集成测试自证；真实环境验证只在该独立 workflow 内发生，其命名场景即该 workflow 的 plan rows。未验证的真实环境行为如实记录，不伪称通过。 - 依赖允许即并行。 PM 对无依赖、写所有权及 worktree 隔离的 ready tasks 并行派发；共享写目标、同一 session/ledger、前置接口与 integration merge 才按具体约束串行。leaf 不因并行策略获得派发权限。
- 完成即交付。 Assignment 给出任务、输入、所有权、允许检查与可观察结果；执行者只解答这些问题，不重复分析已解决内容、不顺手修复或增加“保险”检查。真实范围缺口返回 PM，已有证据充分即停止。
核心研发守则
全局工程不变量，适用于所有角色；实现级操作细节（The Ladder、surgical、debugging 等）→ 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-rolesPM 节）。 - 工期仅 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 等 — 见上表索引。