SuperAPI AI 工具集

northstar-setup

部署与运维

查看项目

更新于 10-15 22:37

技能介绍

用途:当用户要求把仓库或项目纳入 Northstar、围绕 Northstar 文档与工作约定搭建或规范化仓库、使用 Northstar 与 Effigy、创建文档骨架/变更日志/发布姿态/仓库 QA 循环,或迁移到更严格的交付护栏时,使用本技能。

主要能力:确认仓库形态、当前文档姿态与已安装工具面;选择采纳模式(单仓库、薄工作区根加文档权威仓库、或兼容模式);构建标准文档主线(愿景、架构、契约、路线图、日志),或更严格主线(增加产品护栏、契约索引、001-working-rules、specs/ 主规范、roadmaps/gNN/batch-cards/ 执行卡);按需安装更严格交付层;用 assets/templates 的模板而非自创结构;最终留下 README.md、AGENTS.md、effigy.toml、CHANGELOG.md、scripts/README.md 及 docs 各 README、策略文件等成套表面。

使用方式:先确认仓库形态与工具,按可用情况运行 effigy tasks、effigy doctor、effigy test --plan、effigy docs --help、effigy release --help,再按 references/adoption-modes.md 选择模式,并按 references/repo-contract.md 应用仓库契约。工作流为:检查仓库状态(README.md、AGENTS.md、文档前门、Effigy)→ 应用契约并保持根目录精简 → 复用 Northstar 模板选择基线或严格主线 → 复杂或长期项目安装交付层 → 从 assets/templates 选择顶层模板 → 用 qa、qa:docs、qa:northstar、release 等现有检查验证 → 在路线图或日志中留一个明确的下一步任务。

限制与护栏:v1.0 前不添加兼容别名、垫片、再导出层、废弃桩或静默回退,破坏性重构需先向操作者呈报影响与选项;v1.0 后不随意破坏稳定行为。不要把 Effigy 任务镜像到 package.json 脚本,应直接写 effigy <task>。不要教 --repo . 用法,不要自创 --repo 测试任务或文档结构,不要用 Bash/Python 替代 Effigy 或 TypeScript+Bun。薄工作区容器不应被强加根级文档/变更日志/发布布局;纯文档权威仓库不应承载虚假发布姿态。不要默认兼容模式,也不要假定 PATH 上的 effigy 就是刚构建的二进制,需用 --help 验证。specs/ 为临时规划面,不是永久权威。