SuperAPI AI 工具集

night-market-docs-and-writing

写作与研究

查看项目

更新于 10-15 17:20

技能介绍

用途:维护 claude-night-market 仓库中作为权威事实的文档,包括 CONSTITUTION.md、STEWARDSHIP.md、.claude/rules/、docs/adr/、质量门与测试指南、CHANGELOG.md、api-overview.md 等,并区分手写与生成文件,避免编辑生成文件造成漂移。

主要能力:提供文档权威映射表与更新触发条件;规定行文风格(80 字符换行、ATX 标题、美式拼写、破折号目标为零等);三层 slop 检查(P0 身份泄露等直接失败、文档经济性 0-8 分、句子级禁用词);ADR 编号与状态约定(Accepted、Superseded by ADR-NNNN,不删除或重写被取代的 ADR);CHANGELOG 遵循 Keep a Changelog 1.1.0 与 SemVer;SKILL.md 描述硬上限 160 字符。

使用方式:提交前运行 python3 scripts/check-markdown-links.py <file>;若改动 SKILL.md 运行 python3 plugins/abstract/scripts/validate_budget.py;若改动清单运行 make docs-sync-check。slop 评分可用 uv run --with pyyaml python scripts/slop_score.py --audit <files>、--threshold 3.0 docs book/src、--ratchet HEAD <changed files>。生成文件用 /sanctum:sync-capabilities --fix 修复,不要手改。mdBook 本地构建:cd book && mdbook build。

适用场景:编写或修改仓库文档、ADR、变更日志、技能描述时。

限制:不用于发布、测试、lint 或版本号变更(用 night-market-operations);不用于变更控制分类、GitHub Discussions 操作、插件机制或测试证据标准。docs/backlog/ 与 docs/research/ 为本地 gitignore 内容,非权威文档。部分事实截至 2026-07-02,需按资料中的命令重新核实。