SuperAPI AI 工具集

custom-skills-doc-writer

通用与其它

查看项目

更新于 10-16 04:57

技能介绍

用途:依目標讀者任務與證據界線撰寫、重構與維護技術文件,涵蓋規劃、報告、研究、指南、操作手冊、教學、參考、說明、記錄與標準等類型,並依專案慣例管理路徑、檔名、索引與生命週期。

主要能力:流程分六階段——調查、寫作小卡、文件組裝、語言與事實守門、成稿檢查、發布與維護。可依類型讀取 document-types.md 對應章節,需要證據分級、方案比較、安全操作或任務連結時讀取 content-blocks.md;正式或中英混合文件讀取 language-and-fact-check.md;成稿後依 review-checklist.md 分關檢查;需要決定知識庫位置時讀取 knowledge-base-organization.md。

使用方式:/custom-skills-doc-writer [type] [variant]。type 可為 plan(general、feature、refactoring、migration、rfc)、report(investigation、analysis、status)、research、guide、runbook、tutorial、reference、explanation、record(meeting、incident、decision、changelog)、standard。未指定時先從對話與現有文件推斷;只有選項會改變讀者、用途、保留方式或輸出位置時才向使用者確認。

寫作與檢查重點:正確性優先於任務相關性、清晰度、資訊密度、連貫、一致性與自然度。開頭先給目的、目前答案或行動,再放細節;一章節回答一個主要問題,段落責任重複或缺失時合併或刪除。高風險操作須保留目標、執行身分、影響、前置檢查、完整操作、備份、成功條件、驗證、回復與稽核紀錄。英文說明文字採 ASD-STE100 大原則,但不等於正式符合性判定;不得因簡化改動人物、時間、數字、命令、條件、範圍或不確定性。humanizer-zh-tw 為選用 polish,reference、runbook、standard 與事實型 record 預設不為「更像真人」額外改寫。

發布與限制:時點證據用 YYYYMMDDhh-NN-<title>.md,長期入口用穩定檔名;新 Markdown 預設含 title、type、date、author、status,大型知識庫再加實際會查找的 topic、related_topics、supersedes 或 superseded_by。只有使用者同時提供合法 ASD-STE100 PDF 絕對路徑與已批准的本機檢查器可執行檔路徑時才執行機器檢查,缺少任一項即不執行。讀者或用途無法判定、正式來源衝突、缺少安全或驗收資訊、路徑或工具無效、會建立第二套真相、須批次搬移歷史文件時應停止並請使用者決定。