feature-development-prepare

特性开发准备

前置：使用本 Skill 前，先按 using-nucleus 完成 Nucleus 入口识别（Claude Code 会话由插件 SessionStart hook 自动注入该纪律）。

核心原则

实施计划必须绑定当前阶段真实依赖；它不是脱离 primary feature、特性文档、需求输入和已存在 UI 设计源的普通任务清单。

生成实施计划前必须扫描目标仓库 docs/specs/** 规范事实源，并把适用 rules、缺失 rules 或 setup gap 写入 developmentSpecs；缺失规范不得被静默当作“无要求”。

生成实施计划前必须把 primary feature、需求输入、docs/specs/** 和 UI 设计源发现结果固化为 .nucleus/runs/<workflowRunId>/spec-anchor.json；实施计划必须包含 specAnchor，声明 facts manifest hash、reload policy、pre-edit gate 和 completion gate，供上下文压缩 / 恢复 / 阶段切换后重读。

发现 docs/ui-design/**/*.pen、docs/ui-design/**/ui-prototype.md 或用户 / context 明确提供 UI 设计源时，实施计划必须先区分“当前特性相关设计源”和“仓库候选设计源”；相关设计源必须把 UI 设计源、Pencil frame / UI 状态映射、公共组件 / 公共样式契约和视觉证据路径写成阻塞型验收项；候选设计源必须进入人工计划确认，未确认相关性前不得写 UI 源码。

请求开发计划人工评审前，必须先按 _shared/references/subagent-precheck-protocol.md 执行 subagentPreReview 子代理预审；未取得“材料可提交人工审查”预审结论时，不得请求人工批准计划。

什么时候使用

使用本 Skill：

• 在当前阶段 context 中已有恰好一个 primary feature，且 docs/features/**/feature.md 与需求 / 拆解输入可读时，为该特性准备实施计划。
• 生成回链到 primary feature、特性文档和需求 / 拆解输入的可评审实施计划：Markdown 是人工计划主入口，JSON 是机器事实源和下游输入。

不要使用本 Skill：

• 当前特性文档缺失、需求 / 拆解输入缺失、没有明确单一 primary feature 时。
• 改源码、测试、特性文档、需求文档，或提交、推送、创建 PR/MR、关闭缺陷。
• 把计划写成脱离特性文档的独立 coding checklist。

Checklist

启动本 Skill 后，必须先为每一项创建宿主 todo/task，并按顺序逐项推进、逐项更新状态；Claude Code 用 TodoWrite 或等价宿主 todo，Codex 用计划 / 任务工具。.nucleus/runs/**、summary.md、result.json 只能记录事实，不能替代宿主任务、人工计划确认或人工评审事实。

1. 读取 context 和输入 完成证据：已读 .nucleus/context/<workflowRunId>.json，以及声明 read-only 的需求方案 artifact。 STOP：未读 context 或需求拆解输入时，不得生成任何计划。

2. 校验恰好一个 primary feature 且 feature.md 存在 完成证据：context 中恰好一个 features[].role=primary，且其 docs/features/**/feature.md 已存在。 STOP：缺 primary、多于一个 primary，或 primary feature 文件不存在时，返回 FAILED_BLOCKED。

3. 校验需求 / 拆解输入可读 完成证据：需求 / 拆解输入 artifact 存在、路径合法、read-only 且已记录 hash。 STOP：输入缺失、不可读、路径越界或写策略不符合边界时，ALERT_AND_BLOCK。