Skip to content
cccskills
FreePublished on GitHub

project-milestone-tracker

项目管理里程碑跟踪器(Project Milestone Tracker)——当用户要求代理在代码库/项目会话中规划、跟踪里程碑、记录承诺或事件、生成进度报告时使用。核心:三层里程碑规则(文件依据/客户提供/待确认)+ 原话+时间戳事件记录。

Project milestone tracker: plan and track project milestones, record events with original text + timestamp, generate status reports, using a three-tier milestone rule (contract-sourced / stakeholder-stated / pending-confirmation).

The English summary is being prepared. Showing the original description.

See how to install

Files included (4)

  • SKILL.md4.4 KB
  • scripts/pm_track.py6.3 KB
  • templates/milestone-checklist.md754 B
  • templates/status-report.md422 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Project Milestone Tracker 项目管理里程碑跟踪器

A self-contained local tracker for planning and tracking project work in a repo session — no external service, no cloud, pure local files (Python stdlib only).

When to Use

Use this skill when the user asks the agent to:

  • Plan milestones for a project / break work into tracked milestones
  • Track milestone progress and mark items done
  • Record a promise, decision, or event with original text + timestamp (traceable claims)
  • Generate a project status report (markdown)

It is designed for repo-session work: the agent runs local commands and keeps state in a local JSON file.

Three-Tier Milestone Rule (三层里程碑规则)

Never invent milestone dates. Every milestone must carry a source tier:

TiersourceMeaningBehavior
1fileExtracted from a contract/documentAuthoritative; note the source document
2clientStated verbally by stakeholderRecorded as stated; suggest written confirmation
3pendingNo milestone info yetFlag "ask the client" — never self-plan

How to Use

All commands run via the bundled script (stdlib only, no install):

python3 scripts/pm_track.py --file .pm.json init "东区改造项目"
python3 scripts/pm_track.py --file .pm.json add-milestone "3月15日竣工验收" --source file --due 2026-03-15 --note "依据合同第四章"
python3 scripts/pm_track.py --file .pm.json add-milestone "甲方口头承诺月底回款" --source client --due 2026-03-31
python3 scripts/pm_track.py --file .pm.json add-milestone "材料进场节点待确认" --source pending
python3 scripts/pm_track.py --file .pm.json add-event "甲方说马上回款" --who 王总 --when "2026-03-10 14:30"
python3 scripts/pm_track.py --file .pm.json status
python3 scripts/pm_track.py --file .pm.json report   # markdown report
python3 scripts/pm_track.py --file .pm.json done 1

Commands

CommandWhat it does
init <name>Initialize a project tracker file
add-milestone <title> --source file|client|pending [--due] [--note]Add a milestone with a source tier
add-event <text> [--who] [--when]Record an event with original text + timestamp
done <id>Mark a milestone done
statusShow all milestones + events + pending warnings
reportPrint a markdown progress report

Example

$ python3 scripts/pm_track.py --file .pm.json init "门店装修"
$ python3 scripts/pm_track.py --file .pm.json add-milestone "6月10日完工验收" --source file --due 2026-06-10
$ python3 scripts/pm_track.py --file .pm.json add-milestone "水电改造完成" --source client
$ python3 scripts/pm_track.py --file .pm.json add-event "甲方电话说马上回款" --who 李总
$ python3 scripts/pm_track.py --file .pm.json status
📋 Project: 门店装修
=== 里程碑 (2 open) ===
  ⬜ #1 [file  ] 6月10日完工验收  (due 2026-06-10)
  ⬜ #2 [client] 水电改造完成
=== 事件记录 (1) ===
  • [2026-08-25 15:20] (李总) 甲方电话说马上回款

Data & Portability

  • State is stored in a local JSON file (default .project-tracker.json, or pass --file).
  • Pure Python 3.8+ stdlib (argparse, json, datetime) — no pip installs, no network.
  • Works anywhere the agent has a shell. The JSON file can be committed to the repo or git-ignored.

Templates

A milestone planning checklist and a status report template live in templates/ — copy and adapt.

Pitfalls

  • Never invent due dates for pending milestones — the whole point of the three-tier rule is that the agent asks the client instead of guessing.
  • Store original text, not paraphrases — events keep text verbatim plus when/who so claims are traceable.
  • report prints markdown to stdout; pipe to a file (> report.md) to save.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Handle ActiveCampaign contact and marketing tasks through Rube MCP, a connection for agent tools. Find or create contacts, manage tags and subscriptions, enroll contacts in existing automated workflows, and create follow-up tasks.

  • Finding or registering contacts
  • Adding or removing contact tags
  • Subscribing contacts to lists or unsubscribing them
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Research competitors’ live Meta and Google ads to identify opening hooks, offers, calls to action, and landing pages. Receive a sourced creative brief and up to three test ideas adapted to your product.

  • Find angles for new ad copy
  • Plan creative tests using competitor ads
  • Choose a landing page message
davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Analytics your AI agent can actually use. Track, analyze, run A/B experiments, and optimize across all your projects via CLI. Includes a growth playbook so your agent knows HOW to grow, not just what to track.

The English summary is being prepared. Showing the original description.

davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Teaches when to recall from long-term memory before acting and when to save durable decisions, corrections and failures afterwards. Use when a memory tool or MCP memory server is connected but the agent is not using it consistently, when the user complains that the assistant forgets preferences, conventions or past decisions between sessions, or when setting up persistent memory for a project. Works with any memory backend: a folder of Markdown files, a local MCP server, or a managed service.

The English summary is being prepared. Showing the original description.

davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Audit local AI coding-agent sessions with agenttrace for cost, tokens, tool failures, latency, anomalies, health, diffs, and CI gates.

The English summary is being prepared. Showing the original description.

davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

Checks which private files (.env, keys, secrets) Claude Code and its subagents reached in this project, whether a value came into an agent's context, and which key to change, by running the open source agentwhy CLI over the session records Claude Code already keeps on disk. Use when the user asks whether the agent or a subagent read their .env or other secrets, which private files a session touched, whether a key leaked into the conversation, or which key to rotate. Runs locally and never prints a secret value.

The English summary is being prepared. Showing the original description.

davepoon/buildwithclaude3.7KUpdated Oct 20, 2026

See all skills by davepoon

Report a problem with this skill