Run any Skill in Manus with one click

sf-docs-and-writing

Stars57

Forks14

UpdatedJuly 11, 2026 at 01:38

StoryMoss 文档维护规范、docs of record 清单、版本号同步、提交信息与 house style。何时加载：要发布或推送、要写/更新文档、要 bump 版本、要写 commit message、或被问“文档怎么写/要更新哪些/版本号在哪”时。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

91zgaoge

91zgaoge/StoryMoss

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	sf-docs-and-writing
description	StoryMoss 文档维护规范、docs of record 清单、版本号同步、提交信息与 house style。何时加载：要发布或推送、要写/更新文档、要 bump 版本、要写 commit message、或被问“文档怎么写/要更新哪些/版本号在哪”时。

StoryMoss 文档与写作

Docs of record（每次推送必须同步，AGENTS.md 强制）

文档	用途	更新时机
`README.md`	面向用户的总览 + 安装 + 截图	用户可见行为变化、新功能、新版本动态
`CHANGELOG.md`	版本变更日志	每次版本 bump
`AGENTS.md`	AI 助手项目指南（背景/编码风格/命令/强制规则/最近完成）	每次推送（最近完成功能段）
`PROJECT_STATUS.md`	项目状态	每次推送
`ROADMAP.md`	路线图 + 已知债务	每次推送；新增债务/暂缓决策必须登记
`ARCHITECTURE.md`	系统架构（含分时介入、合同驱动、记忆系统等）	架构变化
`TESTING.md`	测试环境与统计	测试数量/分布变化
`docs/USER_GUIDE.md`	完整用户指南	用户操作路径变化（如 auto-accept 真实路径）

版本号四源统一（强制）

规则的家在 sf-change-control（含违反代价与历史事故）。本技能只记 docs 视角：写文档时引用的版本号必须与四源一致——src-tauri/Cargo.toml 的 version、src-tauri/tauri.conf.json 的 "version"、src-frontend/package.json 的 "version"、git tag vX.Y.Z。Cargo.lock 也需同步（曾出现需 chore: sync Cargo.lock）。

提交信息格式

<type>: <subject>

type: feat / fix / docs / style / refactor / test / chore

历史风格（git log --oneline -30）：

fix: v0.26.23 修复 v0.26.22 CI prettier 格式检查失败
feat: v0.26.19 Genesis 创世流程全面审计与测试加固
style: v0.26.20 修复 v0.26.19 CI cargo +nightly fmt -- --check 失败
chore: sync Cargo.lock version to v0.26.17

约定：subject 常带版本号；多版本连发修 CI 格式时用 style:/fix:。

House style

语言：项目主语言中文；文档与代码注释中文为主，技术名词保留英文。
Rust：snake_case，Result<T,E>，async/await，rusqlite+r2d2。
TypeScript：camelCase，函数组件 + Hooks，Zustand，TanStack Query。
CHANGELOG/AGENTS 历史段：用「根因→修复→验证」三段式，附测试计数变化（如 cargo test --lib 655 passed (+10)）。
新增债务：在 ROADMAP.md 的「已知债务」段登记，含暂缓原因 + 重评估条件（参考「策略选择移入 quick_phase」条目）。

何时 NOT 用本技能

发布命令解剖 → sf-run-and-operate。
门禁规则（tag 不覆盖、CI 必查）→ sf-change-control。
文档里要写的架构内容 → sf-architecture-contract。

出处与维护

重验证命令：
- grep -rE '^version' src-tauri/Cargo.toml src-frontend/package.json + grep '"version"' src-tauri/tauri.conf.json + git tag --sort=-creatordate | head -3
- git log --oneline -10（提交风格）
- ls docs/ docs/archive/（文档清单）
易漂移项：版本号、最近完成功能段（AGENTS.md）、ROADMAP 已知债务。
最后核对：2026-07-07，v0.26.23。

More from this repository

same repository

sf-run-and-operate

91zgaoge/StoryMoss

运行/部署 StoryMoss 的命令解剖、运行时数据与产物落点。何时加载：要启动应用、要找日志、要找数据库/配置文件、要发布 tag、要看生成链路日志、或被问“日志在哪/数据在哪/怎么发布”时。

2026-07-1357

diagnose

91zgaoge/StoryMoss

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

2026-07-1157

sf-architecture-contract

91zgaoge/StoryMoss

StoryMoss 承重设计决策与 WHY、必须成立的不变量、已知弱点。何时加载：要改架构、要动数据真相源、要改生成链路、要改 IPC/SyncEvent、要动数据库层、要评估“能不能这样改”、或被问“为什么这样设计/哪些不能动”时。改任何符号前先用 gitnexus impact。

2026-07-1157

sf-build-and-env

91zgaoge/StoryMoss

从零重建 StoryMoss 开发与构建环境，含已知陷阱。何时加载：首次 clone 后要跑起来、换机器、CI 本地复现、`cargo tauri dev/build` 报环境错、前端起不来、跨平台构建失败、或被问“怎么构建/怎么跑”时。

2026-07-1157

sf-change-control

91zgaoge/StoryMoss

StoryMoss 变更门禁与不可破坏项。何时加载：要提交/推送代码、要 bump 版本、要改架构边界、要动数据库迁移、要改 CI、要发布 tag、要合并 feature 分支、或被问“能不能直接改/直接推”时。也用于判断一个改动是否需要用户授权（R10）。

2026-07-1157

sf-config-and-flags

91zgaoge/StoryMoss

StoryMoss 全部配置轴：选项、默认值、生产 vs 实验、守卫、如何新增。何时加载：要改生成模式、要改并发/超时、要加 PromptRegistry 覆盖、要调体裁模板、要改 silent_background 白名单、要动 rustfmt、或被问“在哪配/默认是什么/这个开关干啥”时。

2026-07-1157

name	sf-docs-and-writing
description	StoryMoss 文档维护规范、docs of record 清单、版本号同步、提交信息与 house style。何时加载：要发布或推送、要写/更新文档、要 bump 版本、要写 commit message、或被问“文档怎么写/要更新哪些/版本号在哪”时。

StoryMoss 文档与写作

Docs of record（每次推送必须同步，AGENTS.md 强制）

文档	用途	更新时机
`README.md`	面向用户的总览 + 安装 + 截图	用户可见行为变化、新功能、新版本动态
`CHANGELOG.md`	版本变更日志	每次版本 bump
`AGENTS.md`	AI 助手项目指南（背景/编码风格/命令/强制规则/最近完成）	每次推送（最近完成功能段）
`PROJECT_STATUS.md`	项目状态	每次推送
`ROADMAP.md`	路线图 + 已知债务	每次推送；新增债务/暂缓决策必须登记
`ARCHITECTURE.md`	系统架构（含分时介入、合同驱动、记忆系统等）	架构变化
`TESTING.md`	测试环境与统计	测试数量/分布变化
`docs/USER_GUIDE.md`	完整用户指南	用户操作路径变化（如 auto-accept 真实路径）

版本号四源统一（强制）

规则的家在 sf-change-control（含违反代价与历史事故）。本技能只记 docs 视角：写文档时引用的版本号必须与四源一致——src-tauri/Cargo.toml 的 version、src-tauri/tauri.conf.json 的 "version"、src-frontend/package.json 的 "version"、git tag vX.Y.Z。Cargo.lock 也需同步（曾出现需 chore: sync Cargo.lock）。

提交信息格式

<type>: <subject>

type: feat / fix / docs / style / refactor / test / chore

历史风格（git log --oneline -30）：

fix: v0.26.23 修复 v0.26.22 CI prettier 格式检查失败
feat: v0.26.19 Genesis 创世流程全面审计与测试加固
style: v0.26.20 修复 v0.26.19 CI cargo +nightly fmt -- --check 失败
chore: sync Cargo.lock version to v0.26.17

约定：subject 常带版本号；多版本连发修 CI 格式时用 style:/fix:。

House style

语言：项目主语言中文；文档与代码注释中文为主，技术名词保留英文。
Rust：snake_case，Result<T,E>，async/await，rusqlite+r2d2。
TypeScript：camelCase，函数组件 + Hooks，Zustand，TanStack Query。
CHANGELOG/AGENTS 历史段：用「根因→修复→验证」三段式，附测试计数变化（如 cargo test --lib 655 passed (+10)）。
新增债务：在 ROADMAP.md 的「已知债务」段登记，含暂缓原因 + 重评估条件（参考「策略选择移入 quick_phase」条目）。

何时 NOT 用本技能

发布命令解剖 → sf-run-and-operate。
门禁规则（tag 不覆盖、CI 必查）→ sf-change-control。
文档里要写的架构内容 → sf-architecture-contract。

出处与维护

重验证命令：
- grep -rE '^version' src-tauri/Cargo.toml src-frontend/package.json + grep '"version"' src-tauri/tauri.conf.json + git tag --sort=-creatordate | head -3
- git log --oneline -10（提交风格）
- ls docs/ docs/archive/（文档清单）
易漂移项：版本号、最近完成功能段（AGENTS.md）、ROADMAP 已知债务。
最后核对：2026-07-07，v0.26.23。