with one click
official-doc-section-common
// 新 project-workspace section 级写作架构的通用规则。所有核心章节和次要章节 section skill 都必须配合本规则使用。流程只消费 framework.md、research-report.md、reference-supplement.md,不执行外部调研。
// 新 project-workspace section 级写作架构的通用规则。所有核心章节和次要章节 section skill 都必须配合本规则使用。流程只消费 framework.md、research-report.md、reference-supplement.md,不执行外部调研。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | official-doc-section-common |
| description | 新 project-workspace section 级写作架构的通用规则。所有核心章节和次要章节 section skill 都必须配合本规则使用。流程只消费 framework.md、research-report.md、reference-supplement.md,不执行外部调研。 |
| allowed-tools | Read Write Edit Bash |
本文件是新 section 级架构的共享规则层。
只有以下文件可以提供事实:
project-workspace/<project-slug>/inputs/framework.mdproject-workspace/<project-slug>/inputs/research-report.mdproject-workspace/<project-slug>/inputs/reference-supplement.mdproject-workspace/<project-slug>/context/evidence-ledger.mdproject-workspace/<project-slug>/context/traceability-matrix.mdproject-workspace/<project-slug>/context/section-plan.mdproject-workspace/<project-slug>/context/artifact-plan.md不得使用 official-doc-research。不得联网搜索。不得推断缺失的项目事实。
每个 section 都按同一流程执行:
section skill 写作 -> section review -> 必要时 section revise -> section review -> approved
每个 section 写入:
project-workspace/<project-slug>/drafts/sections/<section-id>.md
section 草稿只能包含该 section 的正式正文,不得包含:
--- 元数据块section_id:、skill:、evidence_used:、traceability:、task_binding:、char_count:、status: 等交接字段FW-001 等内部证据编号pain_01、major_issue_01、task_01、tech_route_01、output_01、indicator_01、validation_01、application_01 等内部矩阵编号unit_01、member_01、work_package_01、milestone_01、budget_item_01、benefit_01、risk_01、mitigation_01 等次要章节内部矩阵编号当前测试稿 等测试标记;除非该表述属于已接受的非阻断缺口策略写作完成后的交接说明只能写在 agent 回复中,或由 review skill 写入 reviews/<section-id>-review.md。不得附加到 section 草稿末尾。
填补空白、填补...空白、唯一可行路径、国际先进水平、国际领先、国内领先、首创、首次提出、显著提升、大幅提升、全面提升、形成...闭环 等写法;确有输入依据时也应改为稳健表述。填补空白 改为 补齐能力短板 或 完善支撑能力;唯一可行路径 改为 更符合本项目需求的路径;国际先进水平 改为 与成熟工具仍有差距 或 对标成熟应用做法;显著/大幅提升 改为 有助于提升、进一步提升;闭环 改为 衔接关系、闭合管理链条 或直接写清输入、处理、输出、验证。Word/PDF/Windows/Linux/Python/PCA/op2/DNV/RINA 等英文词密集污染正式公文语体。待补充。traceability-matrix.md 将某个缺口标为 blocks_assembly: Yes,该 section 可以进入草稿和 review,但不得通过 review 或装配。.claude/templates/full-research-project-template.md 的标题树。## (三)1. 国内发展现状、## (一)1. 建设目标、## (二)1. 技术路线。####、##### 或更深 Markdown 标题;需要分层时使用自然段开头的“第一,”“第二,”“任务一:”“成果一:”“在……方面”等模板化句式。### 2.1、#### 3.3.1。## (一)...、## (二)...,不得使用 ## 1 ...、## 2 ...。### (一)...。凡是中文括号序号 (一)、(二) 均为二级标题,必须写作 ## (一)...;三级标题只能写作 ### 1. ...、### 2. ...。## (一)... 或 ### (一)... 小节;除非 framework.md 明确给出模板外结构。## 子课题一阶段任务说明、## 子课题二阶段任务说明、## 项目验证阶段任务说明、## 项目总结阶段任务说明 等阶段说明标题。阶段、年度、子课题只能写入章级正文或年度任务安排表。第一章各 section 必须避免内容错位:
ch01-background 写项目建设背景,重点是政策要求、产业场景、业务基础和建设必要性。不得以 DNV、Siemens Teamcenter、Nauticus、PLM 等国外工具和平台开头;这些内容属于国外发展与应用现状。ch01-domestic-status 写国内发展现状,重点是国内船舶行业、中央企业智能化、招商局集团和项目承担单位已有基础。不得写国外厂商、国外产品和国外应用成熟度。ch01-foreign-status 写国外发展与应用现状,重点是国外工具链、船级社规范校核、PLM/CAE/report automation 等成熟做法及其适配不足。不得写国资委、招商局集团、商道平台、上海研究院等国内政策和主体内容。ch01-pain-analysis 写痛点本身,不提前展开第四章技术路线。ch01-major-problems 写待解决重大问题,必须承接痛点并引出第四章建设任务,不得写成成果清单。第四章各 section 必须避免内容错位:
ch04-construction-goal 写目标,不展开任务细节和技术路线。ch04-major-issues 写建设方案要解决的主要问题,不重复第一章痛点原文,不提前写算法步骤。ch04-rd-content 写研发任务、输入、动作、输出和任务关系,不写成技术路线。ch04-technical-route 写路线、流程、数据流、接口、验证和工程应用,不写成研发任务清单。ch04-expected-outputs 写成果来源、成果形态、验证和应用关系,不重复研发任务。ch04-application-promotion 写内部试点、示范应用、推广路径和反馈机制,不写第九章效益测算。ch04-collaboration-mode 写产学研用协同基础、联合研发机制、任务接口和应用反馈,不替代第六章单位任务分工。ch04-open-source-strategy 写与模板对应的攻关成果开源策略,但必须服从保密和知识产权边界,不得编造开源比例、社区或对外发布承诺。ch04-major-issues 的正文只写问题表现、制约影响和建设方向,不得显式写“来源于第一章痛点分析中的……”,不得暴露 pain_01、major_issue_01、task_01 等后台映射。第一章、第四章不得出现以下写法:
应改为模板式公文表达:
当前……,主要表现为……。该问题制约了……,需要通过……形成……能力。
项目实施后,可在……方面发挥作用,为……提供支撑。
第二、三、五、六、七、八、九、十章必须按 .claude/templates/full-research-project-template.md 的对应章节结构写作:
## 子课题...阶段任务说明 作为标题;子课题和阶段信息应进入 表5-1 年度任务安排表 的“年度任务”“年度考核指标”“重要任务的时间节点”列。每个 section 都必须在 section-plan.md 中有 minimum_chars。这是硬门槛。
minimum_chars。minimum_chars。正式正文应当可读,不暴露内部 ID;但写作逻辑必须能通过 traceability-matrix.md 回溯。
必要关系包括:
如果关系缺失,必须向主入口报告,不得自行静默发明矩阵行。
图表是正式正文的一部分,由 artifact-plan.md 统一安排。
type=图 的图表必须调用 official-doc-figure 生成或回修。type=表 的图表必须调用 official-doc-table 生成或回修。.claude/templates/full-research-project-artifact-blueprint.md 的 template_anchor、artifact_type 和写作位置嵌入 section 正文,不能只在交接说明中提到。图X-X 开头,表题必须以 表X-X 开头。待补充。required_per_task 图表必须按每个研发任务分别生成,不得用一个总图替代全部任务图。type=图 的 artifact_id 必须以 图X-X 开头;type=表 的 artifact_id 必须以 表X-X 开头。编号、类型、标题含义不一致时必须报告主入口修正 artifact-plan.md,不得自行生成。图;标题含“清单”“表”“矩阵”“明细”“测算”的,一般应作为 表。若 artifact-plan.md 与该含义冲突,必须阻断。section 只有在 review 确认以下事项后才算完成:
待补充minimum_charsartifact-plan.md 分配给该 section 的必需图表已经嵌入正文section_status: approved