Record decisions in docs-agents/DECISIONS.md — add a TBD (open question), log a decided decision, or revise/revoke an existing one. Use when the user says "decide", "we decided", "log a decision", "that's TBD", or wants to change/revoke a past decision
中文简介正在准备中。当前显示原文说明。
查看安装方法安装前可以查看交给 AI 代理的指令内容。
Maintains docs-agents/DECISIONS.md. Keep entries terse.
Edit docs-agents/DECISIONS.md in the current project. If it doesn't exist, create it with this structure:
# Decisions
## TBD
- **<Shortname> — <pending decision>** — options/context in one line.
## Decided
### DEC-001 — title
Decided by: Author | Author with Agent | Agent
Date: YYYY-MM-DD HH:MM
**Decision:** 1–2 sentences (what was decided).
**Rationale:** 1–2 sentences (why).
1. Add a TBD (open question requiring a decision to move forward, not yet decided).
Not to be confused with an open question from docs-agents/QUESTIONS.md which do not related to decision.
Append to the ## TBD list:
- **<Shortname> — <pending decision>** — options/context in one line.
2. Log a decided decision
DEC-NNN in ## Decided; new id = highest + 1, zero-padded to 3 digits.## Decided (newest first).date "+%Y-%m-%d %H:%M".## TBD item, remove that TBD line.### DEC-NNN — <title>
Decided by: Author | Author with Agent | Agent
Date: YYYY-MM-DD HH:MM
**Decision:** 1–2 sentences (what was decided).
**Rationale:** 1–2 sentences (why).
Set "Decided by" to who actually decided (ask if unclear; default Author with Agent).
Author means the person using the skill.
Agent means the coding agent harness in use.
3. Revise a decision
Locate the DEC-NNN. Do NOT rewrite history silently — append a revision note under the existing entry:
**Revised (YYYY-MM-DD HH:MM):** what changed and why. Supersedes original decision above.
Then move the whole entry to the top of ## Decided. Keep its original id — the number is a stable reference, not a sort key, so recently-touched decisions surface first even if ids end up out of numeric order.
4. Revoke a decision
Prefix the title with ~~REVOKED~~ and append:
**Revoked (YYYY-MM-DD HH:MM):** reason. No longer in effect.
Then move the whole entry to the top of ## Decided (same rule as revise) — a revocation is important activity, so surface the "no longer in effect" warning rather than leaving it buried.
date, never guess.还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Turn uncommitted work into a logically ordered sequence of atomic conventional commits. Surveys the whole working tree, groups changes, orders them foundation-first, shows a plan, then commits by path. Use when the user says "commit this", "commit my work", "split this into commits", or "clean up my changes into commits"
中文简介正在准备中。当前显示原文说明。
Manage docs-agents/GLOSSARY.md — add or refine a canonical term, extract terms from the current conversation, or audit for conflicts and duplicates. Use when the user says "define this term", "add to the glossary", "build a glossary", "what do we call this", or wants to harden terminology
中文简介正在准备中。当前显示原文说明。
Quickly add one entry to the right doc — a task, idea, stack choice, concern, or open question — in the correct format. Triggered by "log"/"note"/"capture"/"add"/"jot down" + the kind, e.g. "log this task", "note this idea down", "capture a concern", "add TODO", "we're using X for Y — put it in the stack", "open question:". Addition only.
中文简介正在准备中。当前显示原文说明。
Rules for AI-written text. Must always apply.
中文简介正在准备中。当前显示原文说明。
Write or update docs-agents/SUM.md — the Software User Manual — from the codebase. Mode 1 (generate) builds a full, detailed SUM from scratch by inventorying every user-facing surface so nothing is missed. Mode 2 (update) revises the SUM against a PR/diff, removing what's obsolete, editing what changed, and adding what's new — precisely and concisely. Triggered by "write the manual", "generate the user manual", "document how to use this", or "update the manual for this PR".
中文简介正在准备中。当前显示原文说明。