원클릭으로 Manus에서 모든 스킬 실행

sf-docs-and-writing

스타57

포크14

업데이트2026년 7월 11일 01:38

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

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

91zgaoge

91zgaoge/StoryMoss

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

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。

이 저장소의 다른 Skills

같은 저장소

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。